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提要 








Python 是 一 种 解释 型 、 面 向 对 象 、 动 态 数据 类 型 的 高 级 程序 设计 语言 。 通 过 


Python 编程 ， 我 们 能 够 解决 现实 生活 中 的 很 多 任务 。 
本 书 通过 14 个 有 趣 的 项 目 ， 帮 助 和 就 励 读者 探索 Python 编程 的 世界 。 全 书 共 
了 通过 Python 编程 实现 的 一 些 有 趣 项 目 ， 包 括 解析 iTunes 播放 列 
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E 命 、 创 建 ASCI 码 艺术 图 、 照 片 拼接 、 生 成 三 维 立 体 图 、 创 建 粒子 


















































模拟 的 烟花 喷 朱 效果、 实现 立体 光线 投 冉 算法 ， 以 及 用 Python 结合 Arduino APTE 











派 等 硬件 的 电子 项 目 





























。 本 书 并 不 介绍 Python 语言 的 基础 知识 , 而 是 通过 一 系列 不 简 



































单 的 项 目 ， 展 示 如 何 





Python 库 。 
AIA A 





Python 语法 和 基本 的 编程 概念 的 读者 进一步 学 习 ， 对 于 Python 程序 员 有 一 定 的 启 


发 和 参考 价值 。 





Bb 些 想 




















] Python 来 解决 各 种 实际 问题 ， 以 及 如 何 使 用 一 些 流行 的 






































通过 Python 编程 来 进行 尝试 和 探索 的 读者 , 适合 了 解 基 本 的 
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旨 在 鼓励 你 探索 Python 





























自己 的 想法 。 


本 书 的 日 标 读者 


假设 你 了 解 基 本 的 Python 语 


经 尽 


不 简 
探索 
的 是 

















i 
的 ， 


本 书 的 目标 读者 ,是 所 有 想 知 道 如 何 利用 编程 来 理解 和 探索 想法 的 人 。 本 书 的 项 目 
首 假设 你 熟悉 高 中 数学 知识 。 我 已 

















法 和 基本 的 编程 概念 ， 

















了 最 大 的 努力 ， 详 细 解 释 了 所 有 项 目 中 需 
































欢迎 阅读 本 书 ! 在 本 书 中 , 你 会 看 到 14 个 令 人 兴奋 的 项 目 ， 


编程 的 世界 。 这 些 项 目 涉及 广泛 的 主题 ， 








如 绘制 类 似 万 花 尺 的 花纹 、 生 成 ASCII 码 艺 术 图 
及 根据 音乐 同步 投射 激光 














. 3D we, WA 


图 像 。 除 了 本 身 很 有 趣 之 外 ， 这 些 项 



















































































要 的 数学 知识 。 















































目的 意图 是 提供 一 些 起 点 ， 让 你 通过 扩展 每 个 项 目 ， 来 探索 你 





本 书 不 会 是 你 的 第 一 本 Python 书 。 我 不 会 指导 你 学 习 基本 知识 。 但 我 会 通过 一 系列 
单 的 项 目 ， 向 你 展示 如 何 用 Python 来 解决 各 种 实际 问题 。 
Python 编程 语言 的 细微 差别 ， 并 学 习 如 何 使 用 一 些 流 行 的 Python 库 。 





在 学 习 这 些 项 目 时 ， 你 将 

















晶 也 许 更 重要 


， 你 将 学 习 如 何 将 问题 分 解 成 几 个 部 分 ， 开 发 一 个 算法 来 解决 这 个 问题 ， 然 后 从 头 


用 Python 来 实现 一 个 解决 方案 。 解 决 现实 世界 
































需要 各 个 领域 的 专业 知识 。 但 Python 















































的 问题 可 能 很 难 ， 因 为 它们 往往 是 开放 式 
提供 了 一 些 工 具 ， 协 助 解决 问题 。 克 服 困 




















难 ， 寻 找 实际 问题 的 解决 方案 ， 这 是 成 为 专家 级 程序 员 的 旅途 中 最 重要 的 环节 。 


本 书 的 内 容 





让 我 们 快速 浏览 一 下 本 书 各 章 的 内 容 。 














第 一 部 分 : 热身 运动 








长 度 和 共同 的 音 轨 。 在 第 2 章 中 
尺 产生 的 那些 曲线 。 























第 二 部 分 : 模拟 生命 
这 部 分 是 用 数学 模型 来 模拟 现象 。 在 第 3 章 中 ， 我 们 将 学 习 如 何 实现 Conway 



































游戏 的 生命 游戏 算法 ， 产 生动 态 的 模式 来 创建 其 他 模式 ， 以 模拟 一 种 人 工 生 命 。 第 

















第 1 章 展示 了 如 何 解析 iTunes 播放 列表 文件 ， 并 从 中 收集 有 用 的 信息 ， 如 音 轨 
， 我 们 使 用 参数 方程 及 海 怨 作 图 法 ， 绘 制 类 似 万 花 
















































































4 章 展 示 了 如 何 用 Karplus-Strong 算法 来 创建 逼真 的 弹拨 音 。 然 后 ,在 第 5 章 中 , 我 
们 将 学 习 如 何 实现 类 乌 群 算法 ， 模 拟 乌 类 的 聚集 行为 。 


























第 三 部 分 : 图 像 之 乐 
这 部 分 介绍 使 用 Python 读 取 和 操作 2D 图 像 。 第 6 章 展 示 了 如 何 根据 图 像 创 建 
ASCI 码 艺术 图 。 在 第 7 章 中 ， 我 们 将 进行 照片 拼接 。 在 第 8 章 中 ， 我 们 将 学 习 如 





















































何 生成 三 维 立 体 图 ， 它 让 人 产生 











第 四 部 分 : 走 进 三 维 

这 一 部 分 的 项 目 使 用 OpenGL 的 3D 图 形 库 。 第 9 章 介 绍 使 用 OpenGL 创建 简单 
3D 图 形 的 基本 知识 。 在 第 10 章 中 ， 我 们 将 创建 粒子 模拟 的 烟花 喷泉 ， 它 用 数学 和 
OpenGL 着 色 器 来 计算 和 演 染 。 在 第 11 章 中 , 我 们 将 使 用 OpenGL 着 色 器 来 实现 立 






































体 光线 投射 算法 ， 来 泻 染 立体 数据 ， 该 技术 常用 于 医疗 影像 ， 如 MRI 和 CTH 


第 五 部 分 : 玩 转 硬 件 
































在 最 后 一 部 分 中 ， 我 们 将 













































































3D 图 像 的 错觉 。 

































































Python 来 探索 Arduino 微 控制 器 和 树 莓 派 。 在 第 














12 章 中 ， 我 们 将 利用 Arduino， 通 过 一 个 简单 电路 读 取 并 标 绘 传感器 数据 。 在 第 13 
章 中 ， 我 们 将 利用 Python 和 Arduino 来 控制 两 个 旋转 镜 和 激光 器 ， 生 成 响应 声音 的 
激光 秀 。 在 第 14 章 中 ， 我 们 将 使 用 树 蔡 派 打造 一 个 基于 网 络 的 气象 监测 系统 。 























为 何 选择 Python 












































Python 是 探索 编程 的 理想 语言 。 作 为 一 种 多 范式 语言 ， 在 如 何 组 织 程序 方面 ， 它 
提供 了 极 大 的 灵活 性 。 你 可 以 将 Python 视 为 脚本 语言 ， 简 单 地 执行 代码 ， 或 将 其 视 为 
过 程 语 言 ， 把 程序 组 织 成 一 组 彼 出 



































































































































调用 的 函数 ， 或 将 其 视 为 面向 对 象 语言 ， 利 用 类 




















灵活 性 让 你 可 以 选择 最 适合 特定 项 目的 编程 风格 。 





继承 和 模块 来 建立 层次 结构 。 这 下 





il 























如 果 用 更 传统 的 语言 来 开发 ， 如 C 或 C ++， 你 必须 先 编译 和 链接 代码 ， 然 后 
才能 运行 它 。 使 用 Python， 你 可 以 编辑 后 直接 运行 它 〈 在 背后 ，Python 将 你 的 代码 
编译 成 中 间 字 节 码 ， 然 后 由 Python 解释 器 运行 ， 但 这 些 过 程 对 用 户 是 透明 的 )。 在 
实践 中 ， 用 Python 多 次 修改 并 运行 代码 ， 要 容易 很 多 。 

此 外 ，Python 解释 器 是 非常 方便 的 工具 ， 可 用 于 检查 代码 语法 ， 获 得 模块 的 帮 
助 ， 进 行 快 速 计算 ， 甚 至 测试 在 开发 中 的 代码 。 例 如 ， 我 写 Python 代码 时 ， 会 打开 
三 个 窗口 : 文本 编辑 器 、 命 令 行 和 Python 解释 器 。 我 在 编辑 器 中 写 代码 时 ， 会 在 解 
释 器 中 导入 我 的 函数 或 类 ， 边 开发 边 测试 。 

Python 有 一 组 非常 小 、 简 单 而 强大 的 数据 结构 。 如 果 你 理解 了 字符 串 、 列 表 、 
元 组 、 字 典 、 列 表 解 析 和 基本 控制 结构 ， 如 for 和 while 循环 ， 那 么 你 已 经 开 了 个 好 
3k. Python 简洁 而 有 表现 力 的 语法 ， 使 得 我 们 很 容易 只 用 几 行 代码 ， 就 完成 复杂 
的 操作 。 而 一 旦 熟悉 Python 内 置 的 模块 和 第 三 方 模块 ， 你 将 拥有 大 量 的 工具 ， 用 于 
解决 真正 的 问题 ， 就 像 本 书 中 介绍 的 那样 。 从 Python 中 调用 C/C++ 代码 有 标准 的 方 
式 ， 反 之 亦 然 。 因 为 在 Python 中 可 以 找到 库 来 做 几乎 所 有 事情 ， 我 们 很 容易 在 大 型 
项 目 中 组 合 使 用 Python 和 其 他 语言 模块 。 这 就 是 为 什么 Python 被 认为 是 了 不 起 的 
胶水 语言 ， 它 可 以 很 容易 地 组 合 使 用 不 同 的 软件 组 件 。 本 书 最 后 的 硬件 项 目 展示 了 
Python 如 何 与 Arduino 和 JavaScript 代码 协作 。 真 实 的 软件 项 目 经 常 使 用 多 种 软件 
BUR, Python 非常 适合 这 种 分 层 体 系 结构 。 

下 面 的 例子 展示 了 Python 的 易 用 性 。 在 第 14 een 
码 时 ， 我 看 着 温度 /湿度 传感器 的 示波器 输出 ， 写 一 串 数字 : 


0011011100000000000110100000000001010001 
因为 我 不 能 用 二 进 制 讲话 ， 所 以 启动 了 Python 解释 器 并 输入 : 


>>> str = '00110111000000000001 10100000000001010001 ' 
>>> len(str) 

40 

>>> [int(str[i:i*8], 2) for i in range(0, 40, 8)] 
[55, 0, 26, 0, 81] 


这 行 代码 将 40 位 字符 串 切 分 转换 成 5 个 8 位 的 整数 ， 这 是 我 可 以 理解 的 。 上 
述 数 据 被 解释 为 55.0% 的 湿度 ， 温 度 为 26.0 摄氏 度 ， 校 验 和 是 55 + 26 = 81. 

这 个 例子 展示 了 如 何 实际 使 用 Python 解释 器 作为 非常 强大 的 计算 器 。 你 不 必 写 
一 个 完整 的 程序 就 能 快速 计算 , 只 要 打开 解释 器 , 就 可 以 开始 .这 只 是 我 喜欢 Python 
的 一 个 原因 ， 原 因 还 有 很 多 ， 所 以 我 认为 你 也 会 喜欢 Python. 
















































































































































































































































































































































































































































































































































































































































































Python 的 版 本 
本 书 基于 Python 3.3.3， 但 所 有 代码 都 与 Python 2.7.x 和 3.x 兼容 。 
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Till 
wo 


本 书 的 代码 








在 本 书 中 ,我 尽 了 最 大 的 努力 引导 你 详细 研究 每 个 项 目的 代码 ， 一 段 接 一 段 地 
进行 。 你 可 以 自己 输入 代码 ， 或 从 https://github.com/electronut/pp/ 或 www.epubit. 
com.cn 下 载 书 中 所 有 程序 的 完整 源 代 码 〈 单 击 Download Zip 选项 )。 

接 下 来 ， 你 会 看 到 一 些 令 人 兴奋 的 项 目 。 我 希望 你 玩 这 些 项 目 时 ， 享 受 的 乐趣 
和 我 创造 它们 时 一 样 多 。 而 且 不 要 忘记 ， 利 用 每 个 项 目 结束 时 提供 的 练习 进一步 探 
索 。 我 希望 你 和 本 书 一 起 度 过 许多 快乐 的 编程 时 光 ! 



















































































小 
m 
ll 


第 1 章 
1.1 
1.2 
1.3 


1.4 
1.5 
1.6 
1.7 


第 2 章 
2.1 





第 一 部 分 
解析 iTunes 播放 列表 tia Fel oo vals wets vie oe es 3 
iTunes 播放 列表 文件 剖析 ………3 
a Ee E 5 
[A f eene 5 
1.3.1 查找 重复 5 
13.2. JEREMIAH 6 
133 查找 多 个 播放 列表 中 
共 同 的 音 轨 ON 信和 7 
1.3.4 收集 统计 信息 站 pp 8 
13.5 £54 eM IA 8 
1.3.6 RATAN eerren 9 
完整 代码 ee 10 
运行 程序 和 13 
小 结 dd odode cog sees e Evene cages 14 
实验 O ATE T E T 14 
AER P 15 
参数 方程 e 16 
211 ZAR GER 17 


K 


热身 运动 
2.1.2 海龟 画图 和 19 
2.2 HISEBRBEre MM MM 20 
2.3 FRG eem mmm 20 
2.3.1 Spiro 构造 函数 : EAN A 20 
2.82. jk BAKE eM 21 
2.33 restart() 2 ;& "————ÓÓ 21 
2.3.4 draw() 方 法 Me 22 
23.5 JÆ RT 22 
2.3.6 SpiroAnimator 类 +--+ 23 
2.3.] genRandomParams()2 ;X--24 
2.3.8 重新 启动 程序 ne 24 
2.3.9 update() 方 法 ——— 25 
2.3.10 显示 或 隐藏 光标 …………… 25 
2.3.11 保存 曲线 S A PEERS 25 
2.3.12 ”解析 命令 行 参数 和 初始 化 …26 
24 完整 代码 a 27 
25 运行 万 花 尺 动画 PEE A 32 
2.6 lee HH 33 
2.7 实验 oooeooeooeooooooooeoseoeoeeooooeooooeosesoeos 33 


第 3 章 
3.1 
3.2 
3.3 


3.4 
3.5 
3.6 
3.7 


第 4 章 


4.1 


4.2 
4.3 


第 6 章 


第 二 部 分 “模拟 生命 








Conway 生命 游戏 e ieee 37 
工作 原理 eM 38 
所 需 模块 eem 39 
aN 40 

3.3.1 Am BAR eM 40 

332 初始 条 件 E ERES CERE 41 

3.3.3 边界 条 件 — —— n S 41 

334 实现 规则 MIRI 42 

3.85 ”向 程序 发 送 命 令 行 参数 ……43 

3.8.6 WA ARA MM 43 
完整 代码 人 44 
运行 模拟 人 生 的 游戏 M 46 
小 结 A ee ma De d 47 
实验 esee eT Vue Tees su eR R 47 

FA Karplus-Strong 算法 产生 
音乐 泛音 A RUNS AYER TEE T ET, 49 
工作 原理 i 51 

Sa Da EE: E y 51 

4.1.2. 创建 WAV xt eM 52 

4.1.3 PEA PPW ereere 53 
所 需 模块 … 54 
aN 54 

4.3.1 用 deque 实现 环形 缓冲 区 …54 


4.3.2 ”实现 Karplus-Strong 算法 …55 


4.4 
4.5 
4.6 
4.7 
第 5 章 
5.1 
5.2 
5.3 


5.4 
5.5 
5.6 
5.7 


第 三 部 分 BALA 





ASCII XXZKE m MM 79 
工作 原理 eM MM HH A 80 
D Tr qu" 81 
代码 dp ee 81 

6.3.1 定义 灰 度 等 级 和 网 格 ……… 82 

录 


4.3.3 5 WAV 文件 seges eee ege eue diese 56 
4.3.4 用 pygame 播放 WAV 
文件 EE esu ut une EPA NUTS TANE 56 
4.3.5 main() 方 法 de 57 
完整 代码 ……… 58 
运行 拨 弦 模拟 ………… 61 
Nl mmn 62 
实验 62 
类 乌 群 : 仿真 鸟 群 aan 63 
工作 原理 weeosssessssessssessesesseseoceseocese 64 
PRRP eee eee emn 64 
[A f eene 64 
5.3.1 计算 类 乌 群 的 位 置 和 速度 …65 
5.3.2 设置 边界 条 件 EUER 66 
533 PAR LG BE eects 67 
5.3.4 应 用 类 鸟 群 规则 ……………… 68 
5.8.5 添加 个 体 和 70 
5.3.6 驱散 类 Bg eR tke Une beer eee 71 
5.3.7 命令 行 参数 ——— 71 
5.4.8 Boids 2 71 
完整 代码 —€——— ——— —— 72. 
AITAS ERU] n 15 
小 结 pa ee 76 
实验 A dd ed Y RE Fa EH eR 76 
632 HEPR cette teens 82 
6.3.3. 从 图 像 生成 ASCII 内 容 …83 
6.3.4 命令 行 选 项 PORIE AE RSA 84 
63.5 + ASCI LAB WF 4 
$ 写 入 文本 文件 egere ero entes 84 


6.4 
6.5 
6.6 
6.7 


第 7 章 
7.1 


7.2 
7.3 


第 9 章 
9.1 
9.2 


9.3 
9.4 








7.4 
7.5 
7.6 
7.7 
第 8 章 
8.1 


8.2 
8.3 


8.4 
8.5 
8.6 
8.7 





7.3.8 ”控制 照片 马赛 克 的 大 小 ……97 
完整 代码 ———— 98 
运行 照片 马赛 克 生 成 程序 102 
AN 103 
实验 PAP EEA A O 103 
三 维 立 体 画 ne 105 
工作 原理 reuse Sag a Eee EA rao EE 106 
8.1.1 感知 三 维 立体 画 中 的 深度 …106 
8.1.2 深度 图 a 108 
所 需 模块 ed en 109 
ARGE eeeeetetrertteetterreerteerreereeeeees: 109 
8.3.1 重复 给 定 的 平 铺 图 像 ……109 
8.3.2 ”从 随机 圆 创建 平 铺 图 像 …110 
8.3.3 创建 三 维 立 体 画 …………… 111 
8.3.4 命令 行 选项 ee 112 
完整 代码 € 113 
运行 三 维 立体 画 生 成 程序 LS 
小 结 —€————— 117 
实验 en 117 


第 四 部 分 “ 走 进 三 维 


完整 代码 OE EO ee 85 
运行 ASCI 文本 图 形 生成 程序 …87 
小 结 RE 87 
实验 Yt di lai ds 88 
ae E EEE 89 
工作 原理 "m——— ÁÓÁÉ(—— 90 
7.1.1 4XJH 标 图 像 ROUES 90 
7.4.2. FR EAE eerste 91 
7.1.3 匹配 图 像 MM MM 91 
所 需 模块 e 92 
代码 和 92 
7.3.1 TEAS ER MM 92 
7.3.2 ”计算 输入 图 像 的 平均 
BRE | 93 
7.3.3 ”将 目标 图 像 分 割 成 网 格 ……93 
73.4. 寻找 小 块 的 最 佳 匹配 ……… 94 
7.4.5 JEB MM 95 
7.3.6 创建 照片 马赛 克 ee 96 
7.3.7 ”添加 命令 行 选项 ……………… 97 
理解 OpenGL. 121 
老式 OpenGL —— —— —( 122 
现代 OpenGL: 三 维 图 形 管 线 …124 
9.2.1 几何 图 QM 124 
922 EYED JA rererere 125 
923 4 ER nd 127 
924 TR 点 缓冲 区 128 
92.5 ZEE) 129 
026 X OpenGL 8 129 
所 需 模块 A argas ia e 130 
代码 Ke eap aai n Tua aia a qu raa aaa a a Gin E 130 
9.4.1 创建 OpenGL 窗口 ……… 130 
9.4.2 jk É wp deese. 131 


9.5 
9.6 
9.7 
9.8 


第 1035 
10.1 


9.4.3 Scene 类 pp 133 
完整 代码 COLTS MULUS MEO 137 
i51] OpenGL 应 用 程序 ……… 142 
小 结 站 143 
实验 ea a 143 
粒子 系统 ENDE TER ER oo 145 

ea: MM MM 146 

10.1.1. 为 粒子 运动 建 模 ………… 147 

10.1.2 ”设置 最 大 范围 cee 147 

10.1.3 È RJE cree ees 149 

10.1.4 利用 OpenGL 混合 来 

创建 更 逼真 火花 XU 149 

10.1.5. 使 用 公告 板 en MM 150 


10.1.6 ERK AE pE eee MM 151 





10.2 所 需 模块 Sten sa 151 
10.3 ”粒子 系统 的 代码 ………………… 151 
10.3.1 定义 粒子 的 几何 形状 ……152 
10.3.2 ”为 粒子 定义 时 间 延 迟 
数组 EE 153 
10.3.3 ”设置 粒子 初始 速度 ……… 153 
10.3.4 创建 顶点 着 色 器 pe 154 
103.5 EKR GE 156 
10.3.6 ee TETTE PEE T EEEEDI TETTE ELI 156 
10.37 Camera AM 158 
10.4 粒子 系统 完整 代码 a 158 
10.5 盒子 代码 E t ae URP ARR eb cu 164 
10.6 主 程序 代码 MM M 166 
10.6.1 每 步 更 新 这 些 粒子 ……… 167 
10.6.2 ”键盘 处 理 程 序 ……………… 168 
10.6.3 ”管理 主 程序 循环 ………… 168 
10.7 ”完整 主 程序 代码 ………………… 169 
10.8 运行 程序 a 172 
10.9 小 结 esate E ne daueme ese tess 172 
10.10 实验 TR 172 
第 11 = WS = Ee 173 
11.1 工作 原理 n RM MH M 174 
11.1.1 数据 格式 174 
11.1.2 生成 光线 站 175 
11.1.3. 显示 OpenGL 窗口 177 
11.2 所 需 模块 Ne 178 

















11.3 ”项 目 代 码 概 述 ……………………… 178 
11.4 生成 三 维 纹 理 a 178 
11.5 ”完整 的 三 维 纹 理 代码 ………… 180 
l6 ELE e e isi 
11.6.1 定义 颜色 立方 体 的 
几何 形状 NUM poc 182 
11.6.2 ”创建 帧 缓冲 区 对 象 ………… 184 
11.6.3 iE XE SEA RM HO 185 
11.6.4 i&X EZ KE d 185 
11.6.5” 演 染 整 个 立方 体 …………… 186 
11.6.6 ”调整 大 小 处 理 程序 ……… 187 
11.7 ”完整 的 光线 生成 代码 ………… 187 
11.8 体 光 线 投 射 odd dd 192 
11.8.1 顶点 着 色 器 "n 194 
11.8.2 FRA EE 194 
11.9 ”完整 的 体 光 线 投射 代码 …… 196 
11.10. CAE Er 199 
11.10.1 TA&X6iXe——— 201 
11102. E EEGRe— 202 
11.10.3 ”针对 二 维 切 片 的 
用 户 界 面 du nie vera eU Vs 202 
1111 完整 的 二 维 切片 代码 ………… 203 
11.12 代码 整合 dieere tto edes el 206 
11.13 ”完整 的 主 文件 代码 ………… 207 
11.14 运行 程序 a 209 
WAS ogee hee eee eres 210 
11.16 ”实验 eee 210 


第 五 部 分 “ 玩 转 硬件 


第 12 章 Arduino 简介 pp 215 
12.1 Arduino pp 216 

122. Arduino 生态 系统 vo 217 
12.2.1 3& € 218 

1222 IDE wee 218 


^H xXx 


12.2.8 社区 eee. 218 
12.2.4 $E 219 
12.3 所 需 模块 E E ed i 219 
12.4 搭建 感光 电路 EEE 219 
12.4.1 电路 工作 原理 en MM 219 


12.4.2. Arduino ££ f reer 220 
12.4.3 AJE REA eee 221 
12.5. Python f&fi e m 222 
12.6 完整 的 Python 代码 n M 224 
12.7 运行 程序 E EEEE AT 226 
12.8 小 结 E E E 227 
12.9 实验 A 227 
第 13 章 激光 音乐 秀 ………………… MM 229 
13.1 用 激光 产生 图 案 sessi eap SERM YT ER 230 
13.1.1 电机 控制 站 230 
13.1.2 ”快速 侍 里 叶 变 换 ………… 232 
13.2 所 需 模块 Mae a 233 
13.2.1 FREI A eM 234 
13.2.2 ”连接 电机 了 驱动 器 ………… 236 
13.3 Arduino fJ 237 

13.3.1 配置 Arduino 数字 
Arudhsmpee——— 238 
1332 PJER eeens 238 
13.33 FEE d ereere 240 
13.4 Python 4f eee 240 
13.4.1 选择 音频 设备 ……………… 241 
13.4.2 ”从 输入 设备 读 取 数 据 ……241 
13.4.3 ”计算 数据 流 的 FFT……… 242 

13.4.4. AX FFT 值 提取 频率 
I) —————— 243 

13.4.5 ”将 频率 转换 为 电机 
速度 和 方向 ee 243 
13.4.6 HAX«SmyukmÉ-.—————- 244 
13.4.7 ”命令 行 选 项 eM 245 
13.4.8 “手动 测试 和 pp 245 
13.5 ”完整 的 Python 代码 n HMM 246 
13.6 运行 程序 RR 249 


13.7 小 结 Se ed ee 250 











13.8 实验 voided dd 250 
第 14 章 基于 树 莹 派 的 天 气 监控 器 ……253 
14.1 ABE Vua vea aio quie quani Vue D TY NR 254 
14.1.1. DHTI1 温 湿 度 传感器 …254 
14.1.2 A|HREX tees 255 
14.1.3 KREMER CER 255 
14.2 ”安装 和 配置 软件 ……………… 256 
14.2.1 操作 系统 T 257 
14.2.2 ”初始 配置 .pp 257 
14.2.3 WiFi 设置 .pe 257 
14.2.4 设置 编程 环境 re 258 
14.2.5 通过 SSH 连接 ………… 259 
14.2.6 Web 框架 Bottle ………… 259 
14.2.7 M flot £249] 260 
14.2.8 KR BR MM 261 
14.3 TERR MM 262 
14.4 代码 on 263 
14.4.1 处 理 传 感 器 数据 请 求 Ms 264 
14.4.2 ”绘制 数据 MM 264 
14.4.3 update() 方 法 —— 267 
14.4.4 用 于 LED 的 JavaScript 
处 理 程序 pp 267 
14.4.5 添加 交互 性 和 pp 268 
14.5 完整 代码 EE es 269 
14.6 运行 程 学 272 
14.7 小 结 村 273 
14.8 实验 EEKEREN SEEEN EEEREN RTEA 273 
附录 A 9 (sche sok en 275 
附录 B 基础 实用 电子 学 ………………………… 281 
附录 C 树 莓 派 的 建议 和 技巧 m 5 


第 一 部 分 


热身 运动 


“在 初学 者 的 头脑 中 有 很 多 可 能 性 ， 
在 专家 的 头脑 中 ， 可 能 性 很 少 。” 
铃木 俊 隆 
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解析 iTunes 播放 列表 


我 们 的 Python 探险 始 于 一 个 简单 的 项 目 ， 该 项 目 在 iTunes 
播放 列表 文件 中 查找 重复 的 乐曲 音 轨 , 并 绘制 各 种 统计 数据 ， 如 
音 轨 长 度 和 评分 。 你 可 以 从 查看 iTunes 播放 列表 格式 开始 ， 然 
后 学 习 如 何 用 Python 提取 这 些 文件 的 信息 。 为 了 绘制 这 些 数据 ， 
要 用 到 matplotlib 库 。 
在 这 个 项 目 中 ， 我 们 将 学 习 以 下 主题 : 
« XML 和 属性 列表 Cp-lisD. 文件 ; 

e Python 列表 和 字典 ; 

e 使 用 Python 的 set 对 象 ; 

。 使 用 numpy 数组 ; 

。 直方 图 和 散 点 图 ; 
e 用 matplotlib 库 绘 制 简单 的 图 ; 
e 创建 和 保存 数据 文件 。 





















































































































































1.1 iTunes 播放 列表 文件 剖析 
iTunes 资料 库 中 的 信息 可 以 导出 为 播放 列表 文件 E iTunes 中 选择 File » Library > 























Export Playlist)。 播 放 列 表 文 件 以 可 扩展 标记 语言 CXMLO 写成 ， 这 是 一 种 基于 
文本 的 语言 ， 则 在 分 层 表示 基于 文本 的 信息 。 它 包括 一 些 用 户 定义 的 标签 所 构成 


的 树 状 集合 ， 标 签 形 如 <MyTag>， 每 个 标签 可 以 有 一 些 属性 和 子 标签 ， 其 中 包含 


















































附加 的 信息 。 
果 在 文本 编辑 器 中 打开 一 个 播放 列表 文件 ， 你 会 看 到 类 似 这 样 的 简化 版 本 : 


<?xml version="1.0" encoding="UTF-8"?> 
© <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www 

.apple.com/DTDs/PropertyList-1.0.dtd"» 
@ «plist version="1.0"> 


如 


e «dict» 
© <key>Ma 

































































jor Version</key><integer>1</integer> 


<key>Minor Version</key><integer>1</integer> 
--snip-- 

e <key>Tracks</key> 
<dict> 























<key>2438</key> 

<dict> 

<key>Track ID</key><integer>2438</integer> 
<key>Name</key><string>Yesterday</string> 
<key>Artist</key><string>The Beatles</string> 
<key>Composer</key><string>Lennon [John], McCartney 
<key>Album</key><string>Help!</string> 


















































[Paul]</string> 








</dict> 
--snip-- 
«[dict» 
[6] <key>Playlists</key> 
<array> 
<dict> 
<key>Name</key><string>Now</string> 
<key>Playlist ID</key><integer>21348</integer> 
--snip-- 
«array» 
«dict» 
<key>Track ID</key><integer>6382</integer> 
</dict> 
--snip-- 
</array> 
</dict> 
</array> 
</dict> 
</plist> 
属性 列表 (P-list) 文件 将 对 象 表示 为 字典 ，<dict> 和 «key» 标签 与 这 种 方式 
关 。 字 典 是 把 键 和 值 关 联 起 来 的 数据 结构 ， 让 查找 值 变 得 容易 。 属 性 列表 文件 使 
字典 的 字典 ， 其 中 和 键 关联 的 值 往往 自身 又 是 男 一 个 词典 (甚至 一 个 字典 列表 )。 


<xml> 标 签 确定 文件 为 XML 文件 ,在 这 个 开始 标签 
XML 文档 的 结构 @。 如 你 所 见 ， 苹 果 在 该 标签 中 的 统一 资 


定义 了 
































中 定义 了 这 种 结构 。 


在 
包含 了 











TES 





有 




















之 后 , 文档 类 型 定义 (DTD ) 

















@ 行 ， 文 件 声 明了 顶层 <plist> 标 签 ， 其 唯一 子 元 素 是 字典 <dict> @。 该 字典 
各 种 键 ， 在 @ 行 ， 包 括 Major Version, Minor Version， 等 等 ， 但 我 们 的 兴 


























4 Python 极 客 项 目 编程 





资源 定位 符 CURL) 




















Ed 


<ER 











在 @ 行 的 Tracks 键 。 注 意 ， 该 键 对 应 的 值 也 是 一 个 字典 ， 它 将 整数 的 音 轨 ID 映射 
到 另 一 个 字典 ， 其 中 包含 Name、Artist 等 元 素 。 音 乐 收 藏 中 的 每 个 音 轨 都 有 唯一 的 
音 轨 ID 键 。 
播放 列表 顺序 在 @ 行 由 Playlists 定义 ， 它 是 顶层 字典 的 一 个 子 节点 。 





















































1.2 ”所 需 模块 


在 这 个 项 目 中 ， 我 们 用 内 置 模块 plistlib 来 读 取 播 放 列 表 文 件 。 我 们 还 用 
matplotlib KAA, H numpy 的 数组 来 存储 数据 。 



























































13 代码 




















该 项 目的 目标 是 找到 你 的 音乐 收藏 中 的 重复 乐曲 ， 确 定 播放 列表 之 间 共 同 的 音 
轨 ， 绘 制 音 轨 时 长 的 分 布 图 ， 以 及 歌曲 评分 和 时 长 之 间 的 关系 图 。 
随 着 音乐 收藏 不 断 增 加 ， 你 总 会 遇 到 重复 的 乐曲 。 为 了 确定 重复 的 乐曲 ， 查 找 
与 Tracks 键 关联 的 字典 中 的 名 称 〈 前 面 讨论 过 )， 找 到 重复 的 乐曲 ， 并 用 音 轨 长 度 
作为 附加 准则 来 检测 重复 的 乐曲 ， 因 为 名 称 相同 、 但 长 度 不 同 的 音 轨 ， 可 能 是 不 一 
样 的 。 






















































































































































































要 找到 两 个 或 多 个 播放 列表 之 间 共 同 的 音 轨 ， 你 需要 将 音乐 收藏 导出 为 播放 列 
表 文 件 ， 收 集 每 个 播放 列表 的 音 轨 名 称 ， 作 为 集合 进行 比较 ， 通 过 发 现 集合 的 交集 
来 找到 共同 的 音 轨 。 
在 收集 音乐 收藏 数据 的 同时 ， 我 们 将 使 用 强大 的 matplotlib Chttp://matplotlib.org/) 
绘图 软件 包 来 创建 一 些 图 ， 该 软件 包 由 已 故 的 John Hunter 开发 。 我 们 可 以 绘制 直 
方 图 来 显示 音 轨 时 长 的 分 布 ， 绘 制 散 点 图 来 比较 乐曲 评分 与 长 度 。 

要 查看 完整 的 项 目 代码 ， 请 直接 跳 到 L4 节 。 







































































































































































13.4 查找 重复 
首先 可 以 用 findDuplicates() 方 法 来 查找 重复 的 曲目 ， 如 下 所 示 : 


def findDuplicates(fileName) : 
print('Finding duplicate tracks in %s...' % fileName) 
# read in a playlist 
o plist - plistlib.readPlist(fileName) 
# get the tracks from the Tracks dictionary 
e tracks = plist['Tracks'] 
# create a track name dictionary 
e trackNames = {} 
# iterate through the tracks 
o for trackId, track in tracks.items(): 
try: 
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e name = track['Name'] 
duration = track['Total Time'] 
# look for existing entries 
[9] if name in trackNames: 


# if a name 


and duration match, increment the count 


# round the track length to the nearest second 
[7] if duration//1000 == trackNames[name][0]//1000: 
count = trackNames[name][1] 
e trackNames[name] = (duration, count+1) 
else: 
# add dictionary entry as tuple (duration, count) 
© trackNames[name] = (duration, 1) 
except: 
# ignore 
pass 
































在 @ 行 ， 文件 作为 输入 ， 并 返回 顶层 字典 。 在 @ 
































MAINE. 









































fj, Wil] Tracks 字典 ， 在 @ 行 ， 创 建 一 个 空 的 字典 ， 用 来 保存 重复 的 乐曲 。 在 @ 
ÍT, 开始 用 items OHIRI Tracks 字典 ,这 是 Python ÆR F H aS AIEEE AY 


在 @@ 行 ， 取 得 字典 中 每 个 音 轨 的 名 称 和 时 长 。 用 in 关键 字 ， 检 查 当 前 乐曲 的 名 























称 是 否 已 在 被 构建 的 字典 


轨 长 度 是 否 相 同 @， 用 /操作 符 ， 将 每 个 音 轨 长 度 除 以 1000, H 








四 舍 五 入 到 最 接近 的 秒 ， 
RUA RABI). GORA 
(duration, count) 元 组 , 
































oa. 











13.2 ”提取 重复 






























































以 进行 检查 《当然 ， 这 意味 着 ， 只 有 毫秒 差异 的 两 个 音 4 





ft, ans d 





































































































利用 以 下 代码 ， 提 取 重 复 的 音 轨 : 


# store duplicates as (name, count) tuples 


o dups = [] 





for k, v in trackNames.items(): 


e if v[1] > 1: 
dups.append((v[ 


1], k)) 


# save duplicates to a file 


print("Found %d duplicates. Track names saved to dup.txt" % len(dups) ) 


print("No duplicate tracks found!") 


% (val[0], val[1])) 


e if len(dups) » O: 
else: 

(4) f = open("dups.txt", "w") 
for val in dups: 

e f.write("[%d] %s\n" 
f.close() 
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有 定 这 两 个 音 轨 长 度 相 等 ， 就 取得 与 name 关联 的 值 ， 这 是 

并 在 @ 行 增加 计数 。 如 果 这 是 程序 第 一 次 遇 到 的 音 轨 名 称 ， 

就 创建 一 个 新 条 目 ，count 为 16. 
将 代码 的 主 for 循环 放 在 try 语句 块 中 , 这 是 因为 一 些 乐 曲 音 轨 可 能 

名 称 。 在 这 种 情况 下 ， 跳 过 该 音 轨 ， 在 except 部 分 只 包含 pass UFA EIO o 


O. 如果 是 这 样 的 ， 程 序 检查 现 有 的 音 轨 和 新 发 现 的 音 
日 毫秒 转换 为 秒 ， 并 


F 





p. 


没有 定义 乐 

















在 @ 行 , 创建 一 个 空 列表 , 保存 重复 乐曲 。 接 下 来 , 迭代 遍历 trackNames 字典 ， 
如 果 count (用 viv, 因为 它 是 元 组 的 第 二 个 元 素 ) 大 于 1@， 则 将 元 组 (name, 
count) 添加 到 列表 中 。 在 @ 行 ， 程 序 打印 它 找 到 的 信息 ， 然 后 用 open() 方 法 将 信息 





















































FAXO. EOT, TEU dups 列表 ， 写 下 重复 的 条 目 。 





1.3.3 ”查找 多 个 播放 列表 中 共同 的 音 轨 





























现在 ， 让 我 们 来 看 看 如 何 找到 多 个 播放 列表 中 共同 的 乐曲 音 轨 : 


def findCommonTracks(fileNames): 
# a list of sets of track names 
trackNameSets - [] 
for fileName in fileNames: 
# create a new set 
trackNames = set() 
# read in playlist 
plist = plistlib.readPlist(fileName) 
# get the tracks 
tracks = plist['Tracks'] 
# iterate through the tracks 
for trackId, track in tracks.items(): 
try: 
# add the track name to a set 
trackNames.add(track['Name']) 
except: 
# ignore 
pass 
# add to list 
trackNameSets.append(trackNames) 
# get the set of common tracks 
commonTracks = set.intersection(*trackNameSets) 
# write to file 
if len(commonTracks) » 0: 
f = open("common.txt", "w") 
for val in commonTracks: 
S = "%s\n" % val 
f.write(s.encode("UTF-8")) 
f.close() 
print("%d common tracks found. " 
"Track names written to common.txt." % len(commonTracks)) 








else: 
print("No common tracks!") 











首先 ， 将 播放 列表 的 文件 名 列表 传 入 findCommonTracksO0， 它 创建 一 个 空 列 表 











@， 保 存 从 每 个 播放 列表 创建 的 一 组 对 象 。 然 后 程序 达 代 遍历 列表 中 的 每 个 文件 。 
对 每 个 文件 ,创建 一 个 名 为 trackNames 的 Python set 对 象 @, 然 后 像 在 findDuplicates() 



























































中 一 样 ， 用 plistlib 读 入 文件 @， 取 得 Tracks 字典 。 接 下 来 ， 迭 代 遍 历 该 
个 音 轨 ， 并 添加 trackNames 对 象 @。 程序 读 完 一 个 文件 中 的 所 有 音 轨 后 , 】 
AJA trackNameSets@。 

















典 中 的 每 


各 这 个 集 


















































在 @ 行 使 用 set.intersection() 方 法 来 获得 集合 之 间 共 同音 轨 的 集合 (用 Python* 





的 运算 符 来 展开 参数 列表 )。 如 果 程序 发 现 集合 之 间 的 共同 音 轨 ， 就 将 音 轨 名 称 写 
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oy 











入 一 个 文件 。 在 @ 行 ， 打 开 文 件 ， 接 下 来 的 两 行 代码 完成 号 入 。 使 用 encode0 来 格 


式 化 输出 ， 确 保 所 有 Unicode 字符 都 正确 处 理 @。 












































1.3.4 ”收集 统计 信息 
接 下 来 ， 用 plotStats0 方 法 ， 针 对 这 些 音 轨 名 称 收 得 


def plotStats(fileName): 
# read in a playlist 
o plist - plistlib.readPlist(fileName) 
# get the tracks from the playlist 
tracks = plist['Tracks'] 
# create lists of song ratings and track durations 
e ratings = [] 
durations - [] 
# iterate through the tracks 
for trackId, track in tracks.items(): 
try: 
e ratings.append(track['Album Rating']) 
durations.append(track['Total Time']) 
except: 
# ignore 
pass 








uw 


Ris E: 





ain 
\ 





# ensure that valid data was collected 
o if ratings -- [] or durations -- []: 
print("No valid Album Rating/Total Time data in %s." % fileName) 
return 


这 里 的 目标 是 收集 评分 和 音 轨 时 长 ， 然 后 画 一 些 图 。 在 @ 行 和 接 下 来 的 代码 行 
中 ， 读 取 了 播放 列表 文件 ， 并 访问 Tracks 字典 。 接 下 来 ,创建 两 个 空 列 表 ， RAED 
分 和 时 长 @ (在 iTunes 播放 列表 中 ， 评 分 是 一 个 整数 ， 范 围 是 0，100])。 和 迭代 遍历 
音 轨 ， 在 自行 ， 将 评分 和 时 长 添加 到 相应 的 列表 中 。 最 后 ， 在 @ 行 检查 完整 性 ， 确 
保 从 播放 列表 文件 收集 了 有 效 数据 。 



































s 







































































1.8.5 ”绘制 数据 
我 们 已 准备 好 绘制 一 些 数 据 了 。 


# scatter plot 





o x = np.array(durations, np.int32) 
# convert to minutes 
e X 7 x/60000.0 
e y = np.array(ratings, np.int32) 
o pyplot.subplot(2, 1, 1) 
e pyplot.plot(x, y, ‘o') 
© pyplot.axis([0, 1.05*np.max(x), -1, 110]) 
o pyplot.xlabel('Track duration') 
e pyplot.ylabel('Track rating') 


# plot histogram 
pyplot.subplot(2, 1, 2) 

© pyplot.hist(x, bins=20) 
pyplot.xlabel('Track duration') 


8 Python 极 客 项 目 编程 


© 


1.3.6 ME 


0o00 


pyplot.ylabel('Count') 


# show plot 
pyplot.show() 





I 

















在 @ 行 ， 利 用 numpy.arrayO0《〈 在 代码 中 作为 np 导入 )， 将 音 轨 时 长 数据 放 到 32 
位 整数 数组 中 。 然 后 在 @@ 行 ， 利 用 numpy， 将 一 个 操作 应 用 于 数组 中 的 每 个 元 素 。 




































































分 保存 另 一 个 numpy 数组 y 中 。 



























































在 这 个 例子 中 ， 将 每 个 以 毫秒 为 单位 的 时 长 值 除 以 值 60X1000。 在 @ 行 ,将 乐曲 评 











用 matplotlib 在 同一 图 像 上 绘制 两 张 图 。 在 @ 行 ， 提 供给 subplotO 的 参数 〈 即 ， 











(2, 1, DO 告诉 matplotlib, 该 图 应 该 有 两 行 (2) 一 列 (1),， 且 下 一 个 点 应 在 第 一 行 (1)。 



























































在 @ 行 ,为 x 轴 和 y 轴 设 置 略 微 大 一 点 儿 的 范围 ， 以 便 在 图 和 轴 之 间 
间 。 在 @ 和 @ 行 ,为 x 轴 和 y 轴 设 置 说 明文 字 。 



























































在 @ 行 ， 通 过 调用 plot0 创 建 一 个 点 ， 并 且 o 告诉 matplotlib 用 圆圈 来 表示 数据 。 


留 一 些 空 





FH 



































现在 用 matplotlib 的 方法 hist0, 在 同一 张 图 中 的 第 二 行 中 , 绘制 时 长 直方 






























































Ee. 


bins 参数 设置 了 数据 分 区 的 个 数 , 其 中 每 分 区 用 于 添加 在 这 个 范围 内 的 计数 。 最 后 ， 












































调用 showO@，matplotlib 在 新 窗口 中 显示 出 漂亮 的 图 

















du. 
o 






































令 行 选项 

现在 ， 我 们 来 看 看 该 程序 的 main() 方 法 如 何 处 理 命令 行 参数 : 
def main(): 

# create parser 

descStr = """ 


This program analyzes playlist files (.xml) exported from iTunes. 


parser = argparse.ArgumentParser (description=descStr) 
# add a mutually exclusive group of arguments 
group = parser.add mutually exclusive group() 


# add expected arguments 

group.add argument('--common', nargs-'*', dest-'plFiles', required-False) 
group.add argument('--stats', dest-'plFile', required-False) 

group.add argument('--dup', dest-'plFileD', required-False) 


# parse args 
args - parser.parse args() 


if args.plFiles: 
# find common tracks 
findCommonTracks(args.plFiles) 
elif args.plFile: 
# plot stats 
plotStats(args.plFile) 
elif args.plFileD: 
# find duplicate tracks 
findDuplicates(args.plFileD) 
else: 
print("These are not the tracks you are looking for.") 
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本 书 的 大 多 数 项 目 都 有 命令 行 参数 。 不 要 尝试 手工 分 析 它 们 并 搞 得 一 团 糟 ， 要 
将 这 个 日 常 的 任务 委派 给 Python 的 argparse 模块 。 在 @ 行 ， 为 此 创建 了 一 个 
ArgumentParser 对 象 。 该 程序 可 以 做 三 件 不 同 的 事情 ， 如 发 现 播 放 列 表 之 间 的 共同 
音 轨 ， 绘 制 统计 数据 ， 或 发 现 播放 列表 中 重复 的 曲目 。 但 是 ， 一 个 时 间 程 序 只 能 做 
其 中 一 件 事 ， 如 果 用 户 决 定 同时 指定 两 个 或 多 个 选项 ,我们 不 希望 它 骨 演 。argparse 
模块 为 这 个 问题 提供 了 一 个 解决 方案 ， 即 相互 排斥 的 参数 分 组 。 在 @ 行 ， 用 
parser.add_mutually_exclusive_group() 方法 来 创建 这 样 一 个 分 组 。 
在 上 日、@ 和 @ 行 ， 指 定 了 前 面 提 到 的 命令 行 选 项 ， 并 输入 应 该 将 解析 值 存 入 的 
变量 名 Cargs.plFiles, args.plFile 和 args.plFileD )， 实 际 解析 在 @ 行 完成 。 参 数 解析 
后 , 就 将 它们 传递 给 相应 的 函数 , findCommonTracks(), plotStats() fll findDuplicates(), 
本 章 前 面 讨 论 过 这 些 函 数 。 
要 查看 参数 是 否 被 解析 ， 就 测试 args 中 相应 的 变量 名 。 例 如 ， 如 果 用 户 没 有 使 
用 --common 选项 (该 选项 找 出 播放 列表 之 间 的 共同 音 轨 )， 解 析 后 args.plFiles 应 该 
设置 为 None。 


在 @ 行 ， 处 理 用 户 未 输入 任何 参数 的 情况 。 





































































































































































































































































































14 ”完整 代码 


下 面 是 完整 的 程序 。 在 https://github.com/electronut/pp/tree/master/playlist/， 你 也 
可 以 找到 本 项 目的 代码 和 一 些 测试 数据 。 


import re, argparse 

import sys 

from matplotlib import pyplot 
import plistlib 

import numpy as np 





def findCommonTracks (fileNames): 


Find common tracks in given playlist files, 
and save them to common.txt. 


# a list of sets of track names 
trackNameSets = [] 
for fileName in fileNames: 

# create a new set 

trackNames = set() 

# read in playlist 

plist = plistlib.readPlist (fileName) 

# get the tracks 

tracks = plist['Tracks'] 

# iterate through the tracks 

for trackId, track in tracks.items(): 

try: 
# add the track name to a set 
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def 


trackNames.add(track['Name']) 
except: 
# ignore 
pass 
# add to list 
trackNameSets.append(trackNames) 
# get the set of common tracks 
commonTracks = set.intersection(*trackNameSets) 
# write to file 
if len(commonTracks) > 0: 
f = open("common.txt", 'w') 
for val in commonTracks: 
S = "%s\n" % val 
f.write(s.encode("UTF-8")) 
f.close() 
print("%d common tracks found. " 
"Track names written to common.txt." % len(commonTracks)) 
else: 
print("No common tracks!") 


plotStats(fileName): 


Plot some statistics by reading track information from playlist. 
# read in a playlist 
plist - plistlib.readPlist(fileName) 
# get the tracks from the playlist 
tracks = plist['Tracks'] 
# create lists of song ratings and track durations 
ratings = [] 
durations = [] 
# iterate through the tracks 
for trackId, track in tracks.items(): 
try: 
ratings.append(track[ ‘Album Rating']) 
durations.append(track['Total Time']) 


except: 
# ignore 
pass 
# ensure that valid data was collected 
if ratings == [] or durations == []: 
print("No valid Album Rating/Total Time data in %s." % fileName) 
return 


# scatter plot 

X= np.array(durations, np.int32) 

# convert to minutes 

x = x/60000.0 

y = np.array(ratings, np.int32) 
pyplot.subplot(2, 1, 1) 

pyplot.plot(x, y, 'o') 

pyplot.axis([0, 1.05*np.max(x), -1, 110]) 
pyplot.xlabel('Track duration') 
pyplot.ylabel('Track rating') 
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# plot histogram 
pyplot.subplot(2, 1, 2) 
pyplot.hist(x, bins=20) 
pyplot.xlabel('Track duration’) 
pyplot.ylabel('Count') 

# show plot 

pyplot.show() 


def findDuplicates(fileName) : 


Find duplicate tracks in given playlist. 
print('Finding duplicate tracks in %s...' % fileName) 
# read in playlist 
plist = plistlib.readPlist (fileName) 
# get the tracks from the Tracks dictionary 
tracks = plist['Tracks'] 
# create a track name dictionary 
trackNames = {} 
# iterate through tracks 
for trackId, track in tracks.items(): 
try: 
name = track['Name'] 
duration = track['Total Time ] 
# look for existing entries 
if name in trackNames: 
# if a name and duration match, increment the count 
# round the track length to the nearest second 
if duration//1000 == trackNames[name][0]//1000: 
count = trackNames[name][1] 
trackNames[name] = (duration, count+1) 


else: 
# add dictionary entry as tuple (duration, count) 
trackNames[name] = (duration, 1) 
except: 
# ignore 
pass 
# store duplicates as (name, count) tuples 
dups = [] 
for k, v in trackNames.items(): 
if v[1] > 1: 


dups.append((v[1], k)) 

# save duplicates to a file 
if len(dups) > 0: 

print("Found %d duplicates. Track names saved to dup.txt" % len(dups) ) 
else: 

print("No duplicate tracks found!") 
f = open("dups.txt", 'w') 
for val in dups: 

f.write("[%d] %s\n" % (val[0], val[1])) 
f.close() 


# gather our code in a main() function 
def main(): 
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# create parser 
descStr = """ 
This program analyzes playlist files (.xml) exported from iTunes. 


parser = argparse.ArgumentParser(description-descStr) 
# add a mutually exclusive group of arguments 
group = parser.add_mutually_exclusive_group() 


# add expected arguments 

group.add_argument('--common', nargs='*', dest='plFiles', required=False) 
group.add argument('--stats', dest-'plFile', required=False) 

group.add argument('--dup', dest-'plFileD', required-False) 


# parse args 
args = parser.parse_args() 


if args.plFiles: 


# find common tracks 
findCommonTracks (args.plFiles) 


elif args.plFile: 


# plot stats 
plotStats(args.plFile) 


elif args.plFileD: 
# find duplicate tracks 
findDuplicates(args.plFileD) 


else: 


print("These are not the tracks you are looking for.") 


# main method 


if name 


== main 





main() 


15 “运行 程序 





下 面 是 该 程序 的 运行 示例 : 





$ python playlist.py --common test-data/maya.xml test-data/rating.xml 














BIER 








co 


5 common tracks found. Track names written to common.txt. 
$ cat common.txt 
God Shuffled His Feet 


Rubric 
Floe 


Stairway To Heaven 


Pi's Lullaby 


moksha:playlist mahesh$ 


让 我 们 绘制 这 些 音 轨 的 一 些 统计 数据 。 





$ python playlist.py --stats test-data/rating.xml 





图 1-1 


` N 


展示 了 这 次 运行 的 输出 。 
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15 
Track duration 








1.6 小 结 


在 这 个 项 目 中 , 我 们 ] 
我 们 学 习 了 一 些 有 用 的 Python 结构 。 在 接 下 来 的 项 目 中 , 你 将 基于 这 














10 15 20 25 
Track duration 


1-1 playlist.py 运行 示例 























基础 知识 ， 探 索 各 种 有 趣 的 主题 ， 深 入 地 研究 Python. 





1.7 实验 





下 面 有 一 些 方法 可 以 扩展 这 个 程序 。 
Mn m 






































于 发 了 一 个 程序 , 分 析 了 iTunes 播放 列表 。 在 这 个 过 程 中 ， 
里 介绍 的 一 些 








相同 。 但 寻找 共同 的 音 轨 时 ， 只 用 了 音 轨 名 称 进行 比较 。 在 findCommonTracksO 中 ， 














请 结 ; 合 首 轨 时 长 作为 额外 的 检查 。 
2. 在 plotStats0 方 法 中 ， 用 了 matplotlib 的 hist0 方 法 来 计算 和 显示 柱状 图 。 请 
编写 代码 手动 计算 直方 图 ， 不 用 hist0 方 法 显示 。 要 将 结果 显示 为 条 





























matplotlib 文档 中 条 形 图 的 部 分 。 








3. A 些 数学 公 




















形 图， 请 阅读 











式 用 于 计算 相关 系数 ， 测 量 两 个 变量 之 间 的 关系 强度 。 阅 读 





相关 性 的 资料 ， 利 用 你 
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自己 的 音乐 数据 ， 计 算 评 分 /时 长 散 点 图 中 的 相关 系数 。 请 考 
虑 可 以 利用 播放 列表 中 收集 的 数据 ， 制 作出 另外 那些 散 点 图 。 


ude 


AER 














我 们 可 以 用 万 花 尺 玩具 (如 图 2-1 所 示 ) 来 绘制 数学 曲线 。 
这 种 玩具 由 两 个 不 同 尺 寸 的 塑料 齿轮 组 成 , 一 大 一 小 。 小 的 齿轮 
有 几 个 孔 。 把 钢笔 或 铅笔 放 入 一 个 孔 , 然后 在 较 大 齿轮 (内 部 有 
WO 内 旋转 里 面 的 小 齿轮 , 保持 笔 与 外 轮 接触 ， 可 以 画 出 无 数 复 
林 而 奇妙 的 对 称 图 案 。 

在 这 个 项 目 中 ， 我 们 将 用 Python 来 创建 动画 ， 像 万 花 尺 一 
样 绘制 曲线 。 我 们 的 spiro.py 程序 将 用 Python 和 参数 方程 来 描述 程序 的 万 花 尺 齿轮 
的 运动 ， 并 绘制 曲线 (我 称 之 为 螺 线 )。 我 们 可 以 将 完成 的 画图 保存 为 PNG 图 像 文 
件 ， 并 用 命令 行 选项 来 指定 参数 或 生成 随机 螺 线 。 
在 这 个 项 目 中 ， 我 们 将 学 习 如 何在 计算 机 上 绘制 螺 线 。 还 将 学 习 以 下 几 点 : 
用 turtle 模块 创建 图 形 ; 
吏 用 参数 方程 ; 
| 用 数学 方程 来 生成 曲线 ; 
日 线段 来 画 曲 线 ; 
日 定时 器 来 生成 图 形 动 画 ; 
将 图 形 保存 为 图 像 文件 。 
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图 2-1 WHR 





关于 这 个 项 目 要 注意 : 我 在 这 个 项 目 中 选择 了 turtle 模块 用 于 说 明 展示 ， 因 为 它 
很 有 趣 ， 但 turtle 比较 慢 ， 如 果 性 能 很 关键 ， 就 不 适合 用 它 来 创建 图 形 《〈 你 对 海龟 有 
何 期 望 ? )。 如 果 想 快速 画图 ， 有 更 好 的 方法 ， 后 面 的 项 目 将 探索 一 些 可 选 方案 。 












































2.1 参数 方程 




















在 本 节 中 ， 你 将 看 到 用 参数 方程 来 画 圆 的 简单 例子 。 参 数 方程 将 曲线 上 点 的 坐 
标 表示 为 一 个 变量 的 函数 ， 该 变量 称 为 参数 。 参 数 方程 让 绘制 曲线 变 得 容易 ， 因 为 
只 要 将 参数 代入 方程 就 能 产生 曲线 。 










































































如 果 你 现在 不 想 学 习 这 部 分 数学 知识 ， 可 以 跳 到 下 一 部 分 ， 讨 论 针 对 万 花 
尺 项 目的 方程 。 
































我 们 开始 考虑 用 半径 x 来 描述 一 个 圆 的 方程 ， 圆 心 位 于 二 维 平面 的 原点 。x、y 
坐标 满足 该 方程 的 所 有 点 构成 了 圆 。 
现在 ， 请 考虑 下 面 的 方程 : 


x= r cos(0) 









































y-rsin(0) 
这 些 方程 是 圆 的 参数 表示 ， 其 中 角 0 是 参数 。 这 些 方程 中 (X, Y) 的 任何 值 ， 
都 满足 前 面 描述 的 圆 的 方程 ，X2 Y^- R). WORE 0 从 0 变 到 2r， 可 以 用 这 些 方程 
来 计算 圆 上 对 应 的 x 和 > 坐标。 图 2-2 展示 了 这 种 方案 。 
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x = rcos(0) 
y = rsin(6) 


2-2 ”用 参数 方程 描述 贺 














记 住 ， 这 两 个 方程 适用 于 圆心 在 坐标 系 原点 的 圆 。 将 圆心 转换 到 点 (o D). W 
可 以 将 圆 置 于 xy 平 面 的 任何 位 置 。 所 以 更 一 般 的 参数 方程 就 变 成 *= a + r cos(A) 


















































和 y=b+rcos(0)。 现 在 ， 让 我 们 来 看 看 描述 螺 线 的 方程 。 


2.1.1 万 花 尺 方程 
Fd 2-3 展示 了 类 似 万 花 尺 运动 的 数学 模型 。 该 模型 没有 齿轮 ， 
轮 只 是 为 了 防止 打滑 ， 而 在 这 里 不 必 担 心 打 滑 。 





















































2-3 万 花 尺 数 学 模型 











因为 玩具 





Hr 
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在 图 2-3 rh, C 是 较 小 的 圆 的 圆心 ，P 是 笔尖 。 较 大 的 圆 半径 为 R， 较 小 的 圆 
半径 为 r。 半 径 之 比 表示 如 下 ; 





P 
R 

将 线段 PC 与 小 圆 半径 > 之 比 作 为 变量 1(1=PC/7r), 它 决定 了 笔尖 离 小 圆 圆心 
有 多 远 。 然 后 ， 组 合 这 些 变量 来 表示 了 的 运动 ， 得 到 如 下 的 参数 方程 : 


k= 




















x= rfa —k)cos(@) + 1k [Ito] 


y= rfa —k)sin(0) +1k | 十 e) 





这 些 曲线 称 为 内 旋 轮 线 和 外 旋 轮 线 。 虽 然 方程 可 能 看 起 来 有 点 吓人 ， 但 推 
导 是 非常 简单 的 。 如 果 你 想 探索 其 中 的 数学 ， 请 参见 维基 百科 。?” 


图 2-4 展示 了 如 何 用 这 些 方程 ， 基 于 参数 的 变化 ， 产 生 一 条 曲线 。 通 过 改变 参 
数 R、r 和 1， 可 以 产生 变化 无 穷 的 迷人 曲线 。 











图 2-4 示例 曲线 
将 曲线 绘制 为 一 系列 点 之 间 的 线段 。 如 果 这 些 点 足够 接近 ， 图 看 起 来 就 像 平 滑 




















的 曲线 。 真 正 玩 过 万 花 尺 就 知道 ， 这 取决 于 使 用 的 参数 ， 万 花 尺 可 能 需要 许多 转 数 
来 完成 。 要 确定 何 时 停止 绘图 ， 就 要 利用 万 花 尺 的 周期 性 ( 即 万 花 尺 图 案 多 久 开始 
重复 )， 研 究 内 外 辆 的 半径 之 比 : 























(D http://en.wikipedia.org/wiki/Spirograph/。 


18 Python 极 客 项 目 编 程 


R 
分 子 分 母 除 以 它们 的 最 大 公约 数 “GCD)， 化 简 该 分 数 ， 分 子 就 告诉 我 们 需要 
多 少 圈 才能 完成 曲线 。 例 如 ， 在 图 2-4 rh, (r, R) 的 GCD 是 5。 
65 























E 
R 220 
下 面 是 该 分 数 化 简 后 的 形式 : 
(65/5) 13 
(220/5) 44 
这 告诉 我 们 ，13 圈 后 ， 曲 线 将 开始 重复 。44 告诉 我 们 小 圆 围绕 其 中 心 旋转 的 
圈 数 ， 它 提示 了 曲线 的 形状 。 在 图 2-4 P% F, SAIRE FEIRER H tE 
好 是 441 
旦 用 简化 形式 表示 了 半径 比 wR， 画 出 螺 线 的 参数 0 范围 就 是 [0，2nr]。 这 告 
诉 我 们 何 时 停止 绘制 特定 的 螺 线 。 不 知道 该 角度 的 结束 范围 ， 就 会 循环 不 止 ， 不 必 


要 地 重复 该 曲线 。 




















































































































































































































2.1.2 AHR 
我 们 可 以 用 Python 的 turtle 模块 来 创建 图 案 。 这 是 一 个 简单 的 绘图 程序 ， 模 型 
是 一 只 海龟 拖 着 尾巴 穿 过 沙滩 ， 留 下 图 案 。turtle 模块 包括 了 一 些 方法 ,用 于 设置 笔 
(海龟 的 尾巴 ) 的 位 置 和 颜色 ， 以 及 其 他 有 用 的 绘图 函数 。 如 你 所 见 ， 只 要 少量 绘 
图 函数 ， 就 可 以 创建 漂亮 的 螺 线 。 
例如 ， 这 个 程序 用 turtle 画 圆 。 输 入 以 下 代码 ,保存 为 drawcircle.py， 在 Python 
中 运行 它 : 

















































































































import math 
© import turtle 


# draw the circle using turtle 
def drawCircleTurtle(x, y, r): 
# move to the start of circle 
turtle.up() 
turtle.setpos(x + r, y) 
turtle.down() 


0o00 


# draw the circle 
e for i in range(0, 365, 5): 
© a = math.radians(i) 
o turtle.setpos(x * r*math.cos(a), y * r*math.sin(a)) 


9 drawCircleTurtle(100, 100, 50) 
O turtle.mainloop() 
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7.047, MSA turtle 模块 开始 。 接 下 来 ， 定 义 drawCircleTurtleQ 7k, EEO 
行 调用 up0。 这 告诉 Python 提 笔 。 换 名 话说 ， 让 笔 离开 虚拟 的 纸 ， 这 样 移 动 海 怨 也 
不 会 画图 。 开 始 绘图 之 前 ， 先 定位 海龟 。 
在 自行 ,将 海 包 的 位 置 设置 为 横 轴 上 的 第 一 个 点 : ktry), HK yy) 是 该 
于 的 圆心 ,现在 准备 好 画图 了 ,所 以 在 @ 行 调用 down0。 在 @ 行 ,利用 range(0, 365, 
5) 开 始 循环 ， 以 5 为 步 长 递增 变量 i， 从 0 到 360， 变 量 i 是 角度 参数 ， 将 传 入 加 
的 参数 方程 , 但 首先 在 @ 行 将 它 从 度 转 为 弧度 (大 多 数 计算 机 程序 的 角度 计算 需 
要 弧度 )。 
在 @ 行 ， 利 用 前 面 讨论 过 的 参数 方程 计算 圆 的 坐标 ， 并 设置 相应 的 海 包 位 置 ， 
这 样 就 从 海 包 上 一 个 位 置 画 线 到 新 计算 的 位 置 ( 从 技术 上 讲 , 产生 的 是 N 边 多 边 形 ， 
但 因为 用 了 很 小 的 角度 ，N 将 非常 大 ， 多 边 形 看 起 来 像 一 个 圆 )。 
在 @ 行 调用 drawCircleTurtle0 来 画 圆 , 在 @ 行 , 调用 mainloop0, 它 保 持 tkinter 
窗口 打开 ， 让 你 可 以 欣赏 你 画 的 圆 CTkinter 是 Python GAB] GUI 8. 。 

现在 ， 我 们 准备 好 画 一 些 螺 线 了 ! 





























































































































































































































































































































































































































2.2 ”所 需 模块 


我 们 将 利用 下 面 的 模块 创建 螺 线 : 
。 turtle 模块 用 于 绘图 ; 
e pillow， 这 是 Python AZE PL) 的 一 个 分 文 ， 用 于 保存 螺 线 图 像 。 







































































23 代码 
































首先 ， 定 义 类 Sipro， 来 绘制 这 些 曲 线 。 我 们 会 用 这 个 类 一 次 画 一 条 曲线 〈 利 
] draw() 方 法 )， 并 利用 一 个 定时 器 和 update0 方 法 ， 产 生 一 组 随机 螺 线 的 动画 。 为 
了 绘制 Spiro 对 象 并 产生 动画 ， 我 们 将 使 用 SpiroAnimator 类 。 

要 查看 完整 的 项 目 代 码 ， 请 直接 跳 到 2.4 节 。 



























































































































































2.3.1 Spiro 构造 函数 
下 面 是 Spiro 构造 函数 : 
# a class that draws a Spirograph 
class Spiro: 
# constructor 


def _ init (self, xc, yc, col, R, r, 1): 


# create the turtle object 


o self.t = turtle.Turtle() 
# set the cursor shape 
e self.t.shape('turtle') 
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# set the step in degrees 


e self.step = 5 
# set the drawing complete flag 
o self.drawingComplete - False 


# set the parameters 
e self.setparams(xc, yc, col, R, r, 1) 


# initialize the drawing 
[5] self.restart() 


EOT, Spiro 构造 函数 创建 一 个 新 的 turtle 对 象 ， 这 将 有 助 于 我 们 同时 绘制 多 条 
螺 线 。 在 四 行 ， 将 光标 的 形状 设置 为 海 怨 《〈 在 https://docs.python.org/3.3/library/ 
turtle.html， 你 可 以 在 turtle 文档 中 找到 其 他 选项 )。 在 目 行 ， 将 参数 绘图 角度 的 增 量 
设置 为 5 度 ， 在 @ 行 ， 设 置 了 一 个 标志 ， 将 在 动画 中 使 用 它 ， 它 会 产生 一 组 螺 线 。 
在 @ 和 @ 行 ， 调 用 设置 函数 ， 接 下 来 讨论 该 函数 。 
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2.3.2 ”设置 函数 


2.3.3 





现在 让 我 们 看 看 getParams() 方 法 ， 它 帮助 初始 化 Spiro 对 象 ， 如 下 所 示 : 


# Set the parameters 
def setparams(self, xc, yc, col, R, r, 1): 
# the Spirograph parameters 




















o self.xc = xc 
self.yc = yc 

e Self.R - int(R) 
self.r - int(r) 
self.l = 1 


self.col = col 

# reduce r/R to its smallest form by dividing with the GCD 
e gcdVal = gcd(self.r, self.R) 
o self.nRot - self.r//gcdVal 

# get ratio of radii 

self.k - r/float(R) 

# set the color 

self.t.color(*col) 

# store the current angle 
e self.a = 0 


在 @ 行 ,保存 曲线 中 心 的 坐标 。 然 后 在 @ 行 ， 将 每 个 圆 的 半径 〈R All) 转换 为 
整数 并 保存 这 些 值 。 在 上 日 行 ， 用 Python 模块 fractions 内 置 的 gcd0 方 法 来 计算 半径 
的 GCD。 我 们 将 用 这 些 信息 来 确定 曲线 的 周期 性 ， 在 @ 行 将 它 保存 为 self.nRot。 最 
后 ， 在 @ 行 ， 保 存 当前 的 角度 ， 我 们 将 用 它 来 创建 动画 。 



































































































































restart() 方 法 
TE PR, restart( ÙY 


# restart the drawing 
def restart(self): 
# set the flag 


























B 








T 
limi 








E EL Spiro 对 象 的 绘制 参数 ， 让 它 准备 好 重 
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o self.drawingComplete - False 
# show the turtle 


e self.t.showturtle() 
# go to the first point 
e self.t.up() 
o R, k, 1 = self.R, self.k, self.l 
a = 0.0 
e x = R*((1-k)*math.cos(a) + l*k*math.cos((1-k)*a/k)) 
y = R*((1-k)*math.sin(a) - 1*k*math.sin((1-k)*a/k) ) 
© self.t.setpos(self.xc + x, self.yc + y) 
o self.t.down() 


























这 里 用 了 布尔 标志 drawingComplete, 来 确定 绘图 是 否 已 经 完成 , 在 @ 行 初始 化 
该 标志 。 绘 制 多 个 Spiro 对 象 时 ， 这 个 标志 是 有 用 的 ， 因 为 它 可 以 追踪 某 个 特定 的 
螺 线 是 否 完成 。 在 @ 行 ， 显 示 海 龟 光 标 ， 以 防 它 被 隐藏 。 在 @ 行 提起 笔 ， 这 样 就 可 
以 在 @ 行 移动 到 第 一 个 位 置 而 不 画 线 。 在 @ 行 ， 使 用 了 一 些 局 部 变量 ， 以 保持 代码 
紧凑 。 然 后 ， 在 @ 行 ， 计 算 角 度 a 设 为 0 时 的 x 和 y 坐标 ， 以 获得 曲线 的 起 点 。 最 
后 ， 在 @ 行 ， 我 们 已 完成 ， 并 落笔 。SetposO 调 用 将 绘制 实际 的 线 。 
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2.3.4 draw 7r ik 
draw() 方 法 用 连续 的 线段 绘制 该 曲线 。 


# draw the whole thing 
def draw(self): 
# draw the rest of the points 
R, k, 1 = self.R, self.k, self.l 












































o for i in range(0, 360*self.nRot + 1, self.step): 
a - math.radians(i) 

e x = R*((1-k)*math.cos(a) + l*k*math.cos((1-k)*a/k)) 
y = R*((1-k)*math.sin(a) - l*k*math.sin((1-k)*a/k)) 


self.t.setpos(self.xc + x, self.yc + y) 
# drawing is now done so hide the turtle cursor 
e self.t.hideturtle() 


在 @ 行 ,迭代 遍历 参数 i 的 完整 范围 ， 它 以 度 表 示 ， 是 360 乘 以 nRot。 在 @ 行 ， 
计算 参数 i 的 每 个 值 对 应 的 X 和 了 坐标 。 在 目 行 ， 隐 藏 光 标 ， 因 为 我 们 已 完成 绘 甫 














AL 











o 





2.8.5 ”创建 动画 
update() 方 法 展示 了 一 段 一 段 绘 秆 
# update by one step 


def update(self): 
# skip the rest of the steps if done 
























































= 
TEE 


线 来 创建 动画 时 所 使 用 的 绘图 方法 。 














o if self.drawingComplete: 
return 
# increment the angle 
e self.a *- self.step 


# draw a step 
R, k, 1 = self.R, self.k, self.l 
# set the angle 

e a - math.radians(self.a) 
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x= self.R*((1-k)*math.cos(a) + 1*k*math.cos((1-k)*a/k) ) 
y = self.R*((1-k)*math.sin(a) - l*k*math.sin((1-k)*a/k)) 
self.t.setpos(self.xc + x, self.yc + y) 
# if drawing is complete, set the flag 
o if self.a >= 360*self.nRot: 
self.drawingComplete - True 
# drawing is now done so hide the turtle cursor 
self.t.hideturtle() 


在 @ 行 ，update0 方 法 检查 drawingComplete 标志 是 否 设置 。 如 果 没 有 设置 ， 则 
继续 执行 代码 其 余 的 部 分 。 在 @ 行 ，update0 增 加 当前 的 角度 。 从 @ 行 开始 ， 它 计算 
当前 角度 对 应 的 (X，Y) 位 置 并 将 海龟 移 到 那里 ， 在 这 个 过 程 中 画 出 线段 。 

讨论 万 花 尺 方程 时 ， 我 提 到 了 曲线 的 周期 性 。 在 一 定 的 角度 后 ， 万 花 尺 的 图 案 
开始 重复 。 在 @ 行 ， 检 查 角 度 是 否 达 这 条 特定 曲线 计算 的 完整 范围 。 如 果 是 这 样 
就 设置 drawingComplete 标志 ， 因 为 绘图 完成 了 。 最 后 ， 隐 藏 海龟 光标 ， 你 可 以 看 
到 自己 美丽 的 创作 。 



















































































































































































2.3.6 SpiroAnimator 类 

SpiroAnimator 类 让 我 们 同时 绘制 随机 的 螺 线 。 该 类 使 用 一 个 计时 器 ， 每 次 绘制 
昌 线 的 一 段 。 这 种 技术 定期 更 新 图 像 ， 并 允许 程序 处 理事 件 ， 如 按键 、 鼠 标点 击 ， 
等 等 。 但 是 ， 这 种 计时 器 技术 需要 对 绘制 代码 进行 一 些 调整 。 
# a class for animating Spirographs 
class SpiroAnimator: 

# constructor 


def — init (self, N): 
# set the timer value in milliseconds 




































































o self.deltaT - 10 
# get the window dimensions 
e self.width - turtle.window width() 


self.height - turtle.window height() 
# create the Spiro objects 
e self.spiros = [] 
for i in range(N): 
# generate random parameters 


o rparams - self.genRandomParams() 
# set the spiro parameters 
e spiro = Spiro(*rparams) 


self.spiros.append(spiro) 
# call timer 
[5] turtle.ontimer(self.update, self.deltaT) 


在 @ 行 ， 该 SpiroAnimator 构造 函数 将 DeltaT 设置 为 10， 这 是 以 毫秒 为 单位 的 
时 间 间 隔 ， 将 用 于 定时 器 。 在 @ 行 ， 保 存 海 包 窗 口 的 尺寸 。 然 后 在 @ 行 创建 一 个 空 
数组 ， 其 中 将 填 入 一 些 Spiro 对 象 。 这 些 封 装 的 万 花 尺 绘制 ， 然 后 循环 N 次 ON 传 
入 给 构造 函数 SpiroAnimator), 在 日 行 创 建 一 个 新 的 Spiro WA, 并 将 它 添加 到 Spiro 
对 象 的 列表 中 。 这 里 的 rparams 是 一 个 元 组 ， 需 要 传 入 到 Spiro 构造 函数 。 但 是 ， 构 
造 函数 需要 一 个 参数 列表 ， 所 以 用 Python 的 * 运 算 符 将 元 组 转换 为 参数 列表 。 
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ix, (EO, Wt turtle.ontimer077 2 f$ DeltaT 毫秒 调用 update(). 











请 注意 ， 在 @ 行 调用 了 
看 这 个 方法 。 




















2.3.7 genRandomParams() 方 法 
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j 助 方法 ， 名 为 genRandomParams()。 接 下 来 就 看 


我 们 用 genRandomParams() 方 法 来 生成 随机 参数 , 在 每 个 Spiro 对 象 创建 时 发 送 








给 它 ， 来 生成 各 种 曲线 。 











# generate random parameters 


def genRandomParams(self): 


width, height - self.width, self.height 


o R = random.randint(50, min(width, height)//2) 
e r = random.randint(10, 9*R//10) 
e 1 = random.uniform(0.1, 0.9) 
o xc = random.randint(-width//2, width//2) 
e yc = random.randint(-height//2, height//2) 
e col = (random.random(), 
random.random() , 
random.random() ) 
o return (xc, yc, col, R, r, 1) 














为 了 生成 随机 数 ， 利 / 














Je A Python 的 random 模块 的 两 个 方法 : randint()， 它 


返回 指定 范围 内 的 随机 整数 ， 以 及 uniformO0， 它 对 浮 点 数 做 同样 的 事 。 在 @ 行 ， 
T4 R 设置 为 50 至 窗口 短 边 一 半 长 度 的 随机 整数 , OT, 将 r 设 置 为 R 的 10% 至 























90% 之 间 。 



































然后 ， 在 @ 行 ， 将 1 设置 为 0.1 至 0.9 之 间 的 随机 小 数 。 在 @ 和 @ 行 ， 在 屏幕 边 















































界 内 随机 选择 x M y 坐标 ， 选 择 屏幕 上 的 一 个 随机 点 作为 螺 线 的 中 心 。 在 @ 行 随机 


设置 为 红 、 绿 和 蓝 颜色 的 成 分 ， 为 





的 参数 作为 一 个 元 组 返回 。 





2.3.8 重新 启动 程序 
























































昌 线 指定 随机 的 颜色 。 最 后 ， 在 @ 行 ， 所 有 计算 











我 们 将 用 男 一 个 restart0 方 法 来 重新 启动 程序 。 


# restart spiro drawing 
def restart(self): 


for spiro in self.spiros: 


# clear 
spiro.clear() 


# generate random parameters 
rparams = self.genRandomParams() 
# set the spiro parameters 
spiro.setparams(*rparams) 


# restart drawing 
spiro.restart() 








它 遍历 所 有 的 Spiro 对 象 ， 清 除 以 前 绘制 的 每 条 螺 线 ， 分 配 新 的 螺 线 参数 ， 然 








后 重新 启动 程序 。 
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2.3.9 update() 方 法 
下 面 的 代码 展示 了 SproAnimator 中 的 update0 方 法 ， 它 由 定时 器 调用 ， 以 动画 
的 形式 更 新 所 有 的 Spiro 对 象 : 


def update(self): 
# update all spiros 













































































o nComplete - O 
for spiro in self.spiros: 
# update 
e spiro.update() 
# count completed spiros 
e if spiro.drawingComplete: 


nComplete += 1 
# restart if all spiros are complete 
o if nComplete == len(self.spiros): 
self.restart() 
# call the timer 
e turtle.ontimer(self.update, self.deltaT) 


update() 方 法 使 用 一 个 计数 器 nComplete 来 记录 已 画 的 Spiro 对 象 的 数目 。 在 @ 
行 初始 化 后 ， 它 遍历 Spiro 对 象 的 列表 ， 在 @ 行 更 新 它们 ， 如 果 一 个 Spiro 完成 ， 就 
在 自行 将 计数 器 加 1。 
在 循环 外 的 @ 行 ， 检 查 计数 器 ， 看 看 是 否 所 有 对 象 都 已 画 完 。 如 果 已 画 完 ， 调 
] restart() 方 法 重新 开始 新 的 螺 线 动画 。 在 @ 行 restartO 的 末尾 ， 调 用 计时 器 方法 ， 
它 在 DeltaT 毫秒 后 再 次 调用 updateO « 
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2.3.10 ”显示 或 隐藏 光标 
最 后 ， 使 用 下 面 的 方法 来 打开 或 关闭 海龟 光标 。 这 可 以 让 绘图 更 快 。 


# toggle turtle cursor on and off 
def toggleTurtles(self): 
for spiro in self.spiros: 
if spiro.t.isvisible(): 
spiro.t.hideturtle() 
else: 
spiro.t.showturtle() 


















































2.8.41 保存 曲线 
使 用 saveDrawing0 方 法 ， 将 绘制 保存 为 PNG 图 像 文件 。 
# save drawings as PNG files 


def saveDrawing(): 
# hide the turtle cursor 

















o turtle.hideturtle() 
# generate unique filenames 

e dateStr = (datetime.now()).strftime( "%d%b%Y -%H%M%S " ) 
fileName = 'spiro-' + dateStr 


print('saving drawing to %s.eps/png' % fileName) 
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# get the tkinter canvas 


e canvas = turtle.getcanvas() 
# save the drawing as a postscipt image 
o canvas.postscript(file = fileName + '.eps') 
# use the Pillow module to convert the postscript image file to PNG 
e img - Image.open(fileName * '.eps') 
e img.save(fileName + '.png', 'png') 
# show the turtle cursor 
[7] turtle.showturtle() 


在 @ 行 ， 隐 藏 海龟 光标 ， 这 样 就 不 会 在 最 后 的 图 形 中 看 到 它 。 然 后 ， 在 四 行 ， 
使 用 datetime()， 利 用 当前 时 间 和 日 期 (以 “日 一 月 一 年 一 时 一 分 一 秒 ” 的 格式 )， 
以 生成 图 像 文件 的 唯一 名 称 。 将 这 个 字符 串 加 在 spiro- 后 面 ， 生 成 文件 名 。 

turtle 程序 采用 tkinter 创建 的 用 户 界 面 (UI) 窗口 ， 在 日 和 @ 行 ， 利 用 tkinter 
的 canvas 对 象 ， 将 窗口 保存 为 艇 入 式 PostScript (EPS) 文件 格式 。 由 于 EPS 是 矢 
量 格式 ， 你 可 以 用 高 分 辩 率 打印 它 ， 但 PNG 用 途 更 广 ， 所 以 在 @ 行 用 Pillow 打开 
EPS 文件 ， 并 在 @ 行 将 它 保存 为 PNG 文件 。 最 后 ， 在 @ 行 ， 取 消 隐藏 海 怨 光 标 。 


















































































































































2.3.12 ”解析 命令 行 参数 和 初始 化 
像 第 1 章 中 一 样 ， 在 main() 方 法 中 用 argparse 来 解析 传 入 程序 的 命令 行 选项 。 


o parser = argparse.ArgumentParser (description=descStr) 





























# add expected arguments 
e parser.add argument('--sparams', nargs-3, dest-'sparams', required-False, 
help="The three arguments in sparams: R, r, 1.") 


# parse args 
e args = parser.parse args() 


在 @ 行 ， 创 建 参数 解析 器 对 象 ， 在 @@ 行 ， 向 解析 器 添加 --sparams 可 选 参数 。 在 
罩 行 ， 调 用 函数 进行 实际 的 解析 。 
接 下 来 ， 代 码 设 置 了 一 些 turtle 参数 。 


# set the width of the drawing window to 80 percent of the screen width 
o turtle.setup(width=0.8) 





# set the cursor shape to turtle 
e turtle.shape('turtle') 


# set the title to Spirographs! 


e turtle.title("Spirographs!") 

# add the key handler to save our drawings 
o turtle.onkey(saveDrawing, "s") 

# start listening 
e turtle.listen() 


# hide the main turtle cursor 
[5] turtle.hideturtle() 
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在 @ 行 用 setup0 将 绘图 窗口 的 宽度 设置 为 800% 的 屏幕 宽度 (你 也 可 以 给 setup 
指定 高 度 和 原点 参数 )。 在 @ 行 ， 设置 光标 形状 为 海 包 ， 在 自行， 设置 程序 窗口 的 标 
题 为 Spirographs !， 在 @ 行 ， 利 用 onkey0 和 saveDrawing， 在 按 下 S 时 保存 图 画 。 
然后 ， 在 @ 行 ， 调 用 listenO) 让 窗口 监听 用 户 事 件 。 最 后 ， 在 @ 行 ， 隐 藏 海龟 光标 。 

命令 行 参数 解析 后 ， 代 码 的 其 余部 分 进行 如 下 : 


# check for any arguments sent to --sparams and draw the Spirograph 


































































































o if args.sparams: 
e params - [float(x) for x in args.sparams] 
# draw the Spirograph with the given parameters 
col = (0.0, 0.0, 0.0) 
e spiro = Spiro(0, 0, col, *params) 
o spiro.draw() 
else: 
# create the animator object 
e spiroAnim - SpiroAnimator(4) 
# add a key handler to toggle the turtle cursor 
[9] turtle.onkey(spiroAnim.toggleTurtles, "t") 
# add a key handler to restart the animation 
o turtle.onkey(spiroAnim.restart, "space") 


# start the turtle main loop 
e turtle.mainloop() 


在 @ 行 ,首先 检查 是 否 有 参数 赋 给 --sparams。 如 果 有 ， 就 从 字符 串 中 提取 它们 ， 
“列表 解析 ”将 它们 转换 成 浮 点 数 @ (列表 解析 是 一 种 Python 结构 ， 让 你 以 紧凑 
而 强大 的 方式 创建 一 个 列表 ， 例 如 ，a = [2*x for x in range(1, 5)] 创 建 前 4 个 偶数 的 
列表 )。 
EOT, 利用 任何 提取 的 参数 来 构造 Spiro 对 象 ( 利 用 Python 的 * 运 算 符 , EK 
列表 转换 为 参数 )。 然 后 ， 在 @ 行 ， 调 用 draw0， 绘 制 螺 线 。 

现在 ， 如 果 命 令 行 上 没有 指定 参数 ， 就 进入 随机 模式 。 在 @ 行 ， 创 建 一 个 
SpiroAnimator 对 象 ， 同 它 传 入 参数 4， 告 诉 它 创 建 4 幅 图 画 。 在 @ 行 ， 利用 onkeyO 
来 捕捉 按键 T， 这 样 就 可 以 用 它 来 切换 海 包 光标 (toggleTurtles), 在 @ 行 ， 处 理 空 
格 键 (space)， 这 样 就 可 以 用 它 在 任何 时 候 重新 启动 动画 。 最 后 ， 在 @ 行 ， 调 用 
mainloopO 告 诉 tkinter 窗口 保持 打开 ， 监 听 事 件 。 
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2.4 完整 代码 


下 面 是 完整 的 万 花 尺 程序 。 也 可 以 从 https:/github.com/electronut/pp/blob/master/ 
spirograph/spiro.py 下 载 该 项 目的 代码 。 


import sys, random, argparse 
import numpy as np 

import math 

import turtle 

import random 
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from PIL import Image 
from datetime import datetime 
from fractions import gcd 


# a class that draws a Spirograph 
class Spiro: 
# constructor 
def | init (self, xc, yc, col, R, r, 1): 


# create the turtle object 
self.t = turtle.Turtle() 

# set the cursor shape 
self.t.shape('turtle') 


# set the step in degrees 
self.step = 5 

# set the drawing complete flag 
self.drawingComplete = False 


# set the parameters 
self.setparams(xc, yc, col, R, r, 1) 


# initialize the drawing 
self.restart() 


# set the parameters 

def setparams(self, xc, yc, col, R, r, 1): 
# the Spirograph parameters 
self.xc = xc 


self.yc = yc 
self.R = int(R) 
self.r = int(r) 
Self.1 = 1 


self.col = col 

# reduce r/R to its smallest form by dividing with the GCD 
gcdVal = gcd(self.r, self.R) 

self.nRot = self.r//gcdVal 

# get ratio of radii 

self.k = r/float(R) 

# set the color 

self.t.color(*col) 

# store the current angle 

self.a= 0 


# restart the drawing 

def restart(self): 
# set the flag 
self.drawingComplete = False 
# show the turtle 
self.t.showturtle() 
# go to the first point 


self.t.up() 
R, k, 1 = self.R, self.k, self.l 
a - 0.0 


x = R*((1-k)*math.cos(a) + 1*k*math.cos((1-k)*a/k) ) 
y = R*((1-k)*math.sin(a) - 1*k*math.sin((1-k)*a/k) ) 
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self.t.setpos(self.xc + x, self.yc + y) 
self .t.down() 


# draw the whole thing 
def draw(self): 
# draw the rest of the points 
R, k, 1 = self.R, self.k, self.l 
for i in range(0, 360*self.nRot + 1, self.step): 
a - math.radians(i) 


x = R*((1-k)*math.cos(a) + 1*k*math.cos((1-k)*a/k) ) 
y = R*((1-k)*math.sin(a) - 1*k*math.sin((1-k) *a/k)) 


self.t.setpos(self.xc + x, self.yc + y) 


# drawing is now done so hide the turtle cursor 


self.t.hideturtle() 


# update by one step 

def update(self): 
# skip the rest of the steps if done 
if self.drawingComplete: 

return 

# increment the angle 

Self.a *- self.step 

# draw a step 

R, k, 1 = self.R, self.k, self.l 

set the angle 

- math.radians(self.a) 


OX © tH 


self.t.setpos(self.xc + x, self.yc + y) 

# if drawing is complete, set the flag 

if self.a >= 360*self.nRot: 
self.drawingComplete = True 


# drawing is now done so hide the turtle cursor 


self.t.hideturtle() 


# clear everything 
def clear(self): 
self.t.clear() 


# a class for animating Spirographs 
Class SpiroAnimator: 
# constructor 
def _ init__(self, N): 
# set the timer value in milliseconds 
self.deltaT = 10 
# get the window dimensions 
self.width = turtle.window width() 
self.height = turtle.window height() 
# create the Spiro objects 
self.spiros = [] 
for i in range(N): 
# generate random parameters 
rparams = self.genRandomParams() 
# set the spiro parameters 
spiro = Spiro(*rparams) 
self.spiros.append(spiro) 


self .R*((1-k)*math.cos(a) + 1*k*math.cos((1-k) *a/k) ) 
= self.R*((1-k)*math.sin(a) - l*k*math.sin((1-k)*a/k)) 
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# call timer 
turtle.ontimer(self.update, self.deltaT) 


# restart spiro drawing 
def restart(self): 
for spiro in self.spiros: 

# clear 
spiro.clear() 
# generate random parameters 
rparams = self.genRandomParams() 
# set the spiro parameters 
spiro.setparams(*rparams) 
# restart drawing 
spiro.restart() 


# generate random parameters 
def genRandomParams(self): 
width, height = self.width, self.height 
R = random.randint(50, min(width, height) //2) 
r = random.randint(10, 9*R//10) 
1 = random.uniform(0.1, 0.9) 
xc = random.randint(-width//2, width//2) 
yc = random.randint(-height//2, height//2) 
col = (random.random(), 
random.random(), 
random.random() ) 
return (xc, yc, col, R, r, 1) 


def update(self): 
# update all spiros 
nComplete = 0 
for spiro in self.spiros: 
# update 
spiro.update() 
# count completed spiros 
if spiro.drawingComplete: 
nComplete += 1 
# restart if all spiros are complete 
if nComplete == len(self.spiros): 
self.restart() 
# call the timer 
turtle.ontimer(self.update, self.deltaT) 


# toggle turtle cursor on and off 
def toggleTurtles(self): 
for spiro in self.spiros: 
if spiro.t.isvisible(): 
spiro.t.hideturtle() 
else: 
spiro.t.showturtle() 


# save drawings as PNG files 
def saveDrawing(): 
# hide the turtle cursor 
turtle.hideturtle() 
# generate unique filenames 
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dateStr = (datetime.now()).strftime( "%d%b%Y -%SH%M%S " ) 
fileName = 'spiro-' + dateStr 

print('saving drawing to %s.eps/png' % fileName) 

# get the tkinter canvas 

canvas = turtle.getcanvas() 

# save the drawing as a postscipt image 
canvas.postscript(file = fileName + '.eps') 

# use the Pillow module to convert the poscript image file to PNG 
img = Image.open(fileName + '.eps') 
img.save(fileName + '.png', 'png') 

# show the turtle cursor 

turtle.showturtle() 


# main() function 


def main(): 
# use sys.argv if needed 
print('generating spirograph...') 
# create parser 
descStr = """This program draws Spirographs using the Turtle module. 


When run with no arguments, this program draws random Spirographs. 
Terminology: 


R: radius of outer circle 
r: radius of inner circle 
1: ratio of hole distance to r 


parser = argparse.ArgumentParser(description-descStr) 


# add expected arguments 
parser.add_argument('--sparams', nargs=3, dest='sparams', required=False, 
help="The three arguments in sparams: R, r, 1.") 


# parse args 
args = parser.parse_args() 


# set the width of the drawing window to 80 percent of the screen width 
turtle.setup(width=0.8) 


# set the cursor shape to turtle 
turtle.shape('turtle') 


# set the title to Spirographs! 
turtle.title("Spirographs!") 

# add the key handler to save our drawings 
turtle.onkey(saveDrawing, "s") 

# start listening 

turtle.listen() 


# hide the main turtle cursor 
turtle.hideturtle() 


# check for any arguments sent to --sparams and draw the Spirograph 


if args.sparams: 
params - [float(x) for x in args.sparams] 
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# draw the Spirograph with the given parameters 
col = (0.0, 0.0, 0.0) 

spiro = Spiro(0, 0, col, *params) 

spiro.draw() 


else: 
# create the animator object 
spiroAnim = SpiroAnimator (4) 
# add a key handler to toggle the turtle cursor 
turtle.onkey(spiroAnim.toggleTurtles, "t") 
# add a key handler to restart the animation 
turtle.onkey(spiroAnim.restart, "space") 


# start the turtle main loop 
turtle.mainloop() 


# call main 
if name == ' main 
main() 








2.5 “运行 万 伦 尺 动画 
现在 该 运行 程序 了 。 
$ python spiro.py 


默认 情况 下 ，spiro.py 程序 绘制 随机 螺 线 ， 如 图 2-5 所 示 。 按 S 键 保存 绘 
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2-5 spiro.py 的 运行 示例 














现在 ， 再 次 运行 程序 ， 这 次 在 命令 行 传 入 参数 ， 画 出 特定 的 螺 线 。 





$ python spiro.py --sparams 300 100 0.9 
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图 2-6 展示 了 和 输出 结果 。 如 你 所 见 ， 这 段 代 码 根据 用 户 指定 的 参数 绘制 了 一 条 





























螺 线 ， 图 2-5 和 它 不 同 ， 展 示 了 几 个 随机 螺 线 的 动画 。 
2-6 用 具体 参数 运行 spiro.py 的 示例 
2.6 小 结 





























在 这 个 项 目 中 ， 我 们 学 习 了 如 何 创 建 万 花 尺 那样 的 曲线 。 我 们 还 学 习 了 如 何 调 
整 输入 参数 ， 来 生成 各 种 不 同 的 曲线 ， 并 在 屏幕 上 产生 动画 。 我 希望 你 喜欢 创造 这 
些 螺 线 (在 第 13 章 你 会 惊喜 地 发 现 ， 可 以 学 到 如 何 将 螺 线 投影 到 墙 上 )。 






























































2.7 实验 











下 面 有 一 些 方 法 可 以 进一步 尝试 螺 线 。 

1. 现在 你 已 知道 如 何 画 圆 ， 请 写 一 个 程序 来 绘制 随机 的 对 数 螺 线 。 找 到 参数 
形式 的 对 数 螺 线 方程 ， 然 后 用 它 来 绘制 螺 线 。 

2. 你 可 能 已 经 注意 到 ， 男 曲线 时 ， 海 包 光 标 总 是 朝 右 ， 但 这 不 是 海龟 移动 的 
方式 ! 请 调整 海 包 的 方向 ， 在 绘制 曲线 时 ， 让 它 朝 问 绘 制 的 方 加 (提示 : 每 步 计 算 
连续 点 之 间 的 方向 矢量 ， 用 turtle.setheading() 方 法 来 调整 海龟 的 方 问 )。 

3. 尝试 用 海 包 绘制 Koch snowflake 〈 科 赫 雪 花 )， 它 是 利用 递归 《〈 即 调用 自身 
的 函数 ) 的 分 形 曲线 。 可 以 像 这 样 组 织 递归 函数 调用 ; 


# recursive Koch snowflake 
def kochSF(x1, y1, x2, y2, t): 
# compute intermediate points p2, p3 
if segment_length > 10: 
# recursively generate child segments 
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# flake #1 

kochSF(x1, y1, p1[O], pi[1], t) 

# flake #2 

kochSF(p1[O], pi[1], p2[0], p2[1], t) 

# flake #3 

kochSF(p2[0], p2[1], p3[0], p3[1], t) 

# flake #4 

kochSF(p3[0], p3[1], x2, y2, t) 
else: 

# draw 

# 











如 果 你 确实 遇 到 困难 ， 可 以 在 http://electronut.in/koch-snowflake-and-the-thue- 
morse-sequence/ 找 到 我 的 解决 方案 。 
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第 二 部 分 


模拟 生命 














“首先 ， 我 们 假设 奶牛 是 一 个 球体 。” 
一 一 佚名 物理 学 笑话 

















"s 


Conway 生命 游戏 











你 可 以 用 计算 机 来 研究 一 个 系统 ,方法 是 建立 该 系统 的 数学 
模型 ， 编 程 表 示 该 模型 ， 然 后 让 该 模型 随 着 时 间 的 推移 而 演进 。 
有 很 多 种 计算 机 模拟 ,但 我 会 专注 于 一 个 著名 的 模拟 , 妈 Conway 
生命 游戏 , 它 是 英国 数学 家 John Conway WAR. AE dm dito e d 
胞 自动 机 , 即 网 格 上 的 一 组 彩色 细胞 , 根据 定义 相 邻 细胞 状态 的 
一 组 规则 ， 经 过 一 些 时 间 逐 步 演 进 。 

这 个 项 目 将 创建 一 个 NXN 的 细胞 网 格 ， 通 过 应 用 Conway 生命 游戏 的 规则 ， 
模拟 系统 随时 间 的 演进 。 你 将 显示 每 个 时 间 段 的 游戏 状态 ， Te 式 将 输出 
保存 到 文件 。 你 会 设置 系统 的 初始 状态 , 要 么 是 随机 分 布 , 要么 是 预先 设计 的 图 案 。 

该 模拟 由 以 下 几 部 分 组 成 : 

。 在 一 维 或 两 维 空间 中 定义 的 属性 ; 
。 在 模拟 中 的 每 一 步 ， 改 变 这 种 属性 的 数学 规则 ; 
。 随 着 系统 的 演进 ， 显 示 或 记录 系统 状态 的 方式 。 

在 Conway 生命 游戏 中 的 细胞 可 以 处 于 ON 或 OFF 状态 。 游戏 从 一 个 初始 状态 
开始 , 其 中 每 个 细胞 分 配 一 个 状态 , 数学 规则 决定 其 状态 如 何 随时 间 而 改变 ,Conway 
生命 游戏 中 令 人 惊奇 的 是 ， 只 有 4 个 简单 的 规则 ， 系 统 演进 会 产生 行为 极其 复杂 的 
图 案 ， 仿 佛 它们 是 活 的 。 图 案 包 括 “ 滑 翔 机 ” BERKERS, “ZIR”, 即 闪 烁 















































































































































































































































































































































ON 和 OFF， 甚 至 还 有 复制 
当然 ， 这 个 游戏 的 哲学 意义 也 很 


图 案 。 











EXE, A 





单 的 规则 演进 ， 不 必 遵 循 任何 一 种 预 设 的 模式 。 





下 面 是 该 项 目 




















包含 的 一 些 主要 概念 : 
利用 matplotlib imshow 来 展示 数据 
利用 matplotlib 生成 动画 ; 
使 用 numpy 数组 ; 
































将 % 运 算 符 














设置 值 
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] 于 边界 条 件 ; 


T 








的 随机 分 布 。 


















































所 示 。 模拟 中 的 给 定 细胞 Gi,j) 用 二 维 数 组 
标 。 在 给 定时 间 段 ， 给 定 细胞 的 值 取决 了 
命 游戏 有 4 个 规则 。 

1. 如 果 一 个 细胞 为 ON， 邻居 

2. 如 果 一 个 细胞 为 ON, 

3. 如 果 一 个 细胞 为 ON， 邻 居 ! 

4. 如 果 一 个 细胞 为 OFF， 邻 居 





这 些 规则 是 为 了 反映 一 些 基 本 方式 ， 即 一 群生 物体 随时 间 推 移 的 遭遇 : 如果 
邻居 少 于 2 或 多 于 3, f 
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因为 生命 游戏 建立 在 9 个 方 格 的 网 格 中 ， 每 个 


的 二 维 网 格 ; 


































































































(i+1, j-1) 





GPR, X 











(i-1, j+1) 


(i+1, j+1) 


3-1 8 个 相 邻 细胞 














! 群 太 少 或 种 条 





胞 有 8 PHR 





为 它们 表明 ， 复 杂 的 结构 可 以 根据 简 











胞 ， 如 图 3-1 


























P Bir — ET Ta) EE hé 








EK AE BAI 


Wu. 4 




















i 和 j 分 别 是 行 和 列 的 下 
邻居 的 状态 。Conway 生 


少 于 两 个 为 ON， 它 变 为 OFF。 
邻居 中 有 两 个 或 3 个 为 O 
超过 3 个 为 ON， 它 变 为 OFF。 

中 恰好 有 3 个 为 ON， 它 变 为 ON。 


N， 它 保持 为 ON。 


















































胞 变 为 OFF; 如 

















果 种 群 平衡 ， 细 胞 保持 为 ON 并 繁殖 ， 将 另 一 个 细胞 从 OFF 变 为 ON。 但 是 ， 在 网 
格 边缘 的 细胞 呢 ? 哪些 细 胞 是 自己 的 邻居 ? 要 回答 这 个 问题 ， 就 要 考虑 边界 条 件 ， 
决定 细胞 在 网 格 边缘 或 边界 时 的 规则 。 我 将 采用 环形 边界 条 件 ， 这 意味 着 正方 形 网 
格 卷 起 来 ， 构 成 一 个 环 面 ， 从 而 解决 这 个 问题 。 如 图 3-2 所 示 ， 网 格 先 卷 起 来 ， 使 
它 的 水 平 边缘 CA MB) 相连 ， 形 成 一 个 圆柱 体 ， 然 后 圆柱 体 的 垂直 边缘 (C 和 D) 
相连 ,以 形成 一 个 环 面 。 形 成 环 面 后 ， 所 有 细胞 都 有 邻居 ， 因 为 整个 空间 没有 边缘 。 


ae | 










































































































































































图 3-2 环 型 边界 条 件 的 概念 视图 





注意 这 类 似 于 Pac-Man ( 吃 豆 子 ) 在 边界 的 工作 方式 。 如 果 超 出 了 屏幕 的 顶部 ， 
就 会 重新 在 底部 出 现 。 如 果 超出 了 屏幕 的 左 侧 ， 就 会 重新 在 右 侧 出 现 。 这 种 边 
界 条 件 在 二 维 模拟 中 很 常见 。 











以 下 是 算法 描述 ， 我 们 用 它 来 应 用 这 4 个 规则 ， 并 运行 模拟 。 

1. 初始 化 网 格 中 的 细胞 。 

2， 在 模拟 的 每 个 时 间 段 ， 对 于 网 格 中 每 个 细胞 (i,j))， 做 下 面 的 事 : 
a. 根据 它 的 邻居 更 新 细胞 Gi, j)) 的 值 ， 同 时 考虑 到 边界 条 件 ; 
b， 更 新 网 格 值 的 显示 。 

























































































3.2 ”所 需 模块 


用 numpy 数组 和 matplotlib 库 来 显示 模拟 的 输出 ， 用 matplotlib animation 模块 
新 模拟 《对 于 matplotlib 的 综述 见 第 1 章 )。 
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33 代码 





我 们 将 在 Python 解释 器 中 一 点 一 点 地 为 模拟 编写 代码 , 考察 不 同 部 分 所 需 的 代 
码 片段 。 要 碍 看 完整 的 项 目 代码 ， 请 直接 跳 到 3.4 节 。 
首先 ， 导 入 该 项 目 使 用 的 模块 : 


>>> import numpy as np 
>>> import matplotlib.pyplot as plt 
>>> import matplotlib.animation as animation 


现在 让 我 们 创建 网 格 。 





























3.3.1 表示 网 格 
为 了 在 网 格 上 表示 细胞 的 活 CON) 或 死 (OFF)， 分 别 用 255 和 0 作为 ON 和 
OFF 的 值 。 我 们 将 采用 matplotlib 的 imshow0) 方 法 ， 来 显示 网 格 当 前 的 状态 ， 将 一 
个 数字 矩阵 表示 为 一 张 图 像 。 请 输入 以 下 内 容 : 
© >>> x = np.array([[0, 0, 255], [255, 255, 0], [0, 255, 0]]) 


@ >>> plt.imshow(x, interpolation='nearest' ) 
plt.show() 

































































在 @ 行 ， 定 义 了 3X3 的 二 维 numpy 数组 ， 数 组 中 的 每 个 元 素 是 一 个 整数 值 。 
然后 ， 在 @ 行 ， 用 pltshow() 方 法 将 这 个 矩阵 的 值 显示 为 图 像 ， 并 给 interpolation Xë 
项 传 入 nearest' 值 ， 以 得 到 尖锐 的 边缘 〈 和 否则 是 模糊 的 )。 

图 3-3 展示 了 这 段 代码 的 输出 。 


-0.5 
































2.5 


3-3 显示 网 格 的 值 
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JER, 0 (OFF) 显示 为 暗 灰 色 ，25$ (ON) 显示 为 浅 灰色 

















的 默认 颜色 。 


3.3.2 ”初始 条 件 


3.3.3 


要 开始 模拟 ， 先 为 二 维 网 格 中 的 每 个 细胞 设置 一 个 初始 状态 。 
OFF 细胞 的 随机 分 布 ， 看 看 会 出 现 怎样 的 图 
们 如 何 发 展 。 我 们 将 探讨 这 两 种 方法 。 










































































， 这 是 imshow0O 使 用 














要 采用 随机 的 初始 状态 , 就 使 用 numpy 中 random 模拟 的 choiceQ 77? 




















下 内 容 : 
np.random.choice([0, 255], 4*4, p=[0.1, 0.9]).reshape(4, 4) 
> 
下 面 是 输出 : 
array([[255, 255, 255, 255], 


[255, 
[255, 
[255, 


255, 255, 255], 
255, 255, 255], 
255, 255, 0]]) 





np.random.choice 从 给 定 的 列表 [0,255]' 



































组 ， 所 以 用 .reshape 使 它 成 为 一 个 二 维 数组 。 





要 建立 初始 条 件 来 匹配 特定 图 案 ， 而 不 是 只 填 入 一 组 


始 化 为 零 ， 


因为 这 个 choice077 1X: 















































可 以 使 
R 或 者 添加 一 些 特定 的 图 

















| ON 和 























o 输入 以 


选择 一 个 值 , 每 个 值 出 现 的 概率 由 参数 
p=[0.1, 0.9] 指 定 。 这 里 ， 你 要 求 0 出 现 的 概率 是 0.1 (或 10%)，255 出 
90% Cp 中 两 个 值 相 加 必须 等 于 1). 














出 现 的 概率 是 
创建 了 16 个 值 的 一 维 数 





随机 值 ， 就 将 二 维 网 格 初 














然后 用 一 个 方法 在 网 格 的 特定 行 和 列 增 加 一 个 图 案 ， 如 下 所 示 : 


def addGlider(i, j, grid): 
'""adds a glider with top left cell at (i, j)""" 


o glider = np.array([[O, 0, 255], 
[255, 0, 255], 
[0, 255, 255]]) 
e grid[i:i*3, j:j+3] = glider 


© grid = np.zeros(N*N).reshape(N, N) 


© addGlider(1, 


1, grid) 











t01 
稳 穿 越 的 图 

















零 值 数组 





~ 











， 用 3X3 的 numpy 数组 定义 了 滑翔 机 图 案 

















案 )。 在 @ 行 ， 可 以 看 到 如 何 





























在 @ 行 ， 调 用 addGlider0 方 法 ， 








边界 条 件 


现在 ， 





格 的 右边 缘 会 发 生 什么 情况 。 














初始 化 带 有 滑翔 机 图 

















将 这 种 图 








《看 上 去 是 一 种 在 网 格 中 平 
J numpy 的 切片 操作 ， 
制 到 模拟 的 二 维 网 格 中 , 它 的 左上 角 放 在 1 和 j 指定 的 坐标 。 在 目 行 ， 


案 数 组 复 


创建 NXN 的 


案 的 网 格 。 


我 们 可 以 想 一 下 如 何 实现 环形 边界 条 件 。 首 先 ， ee NXN 网 








i 行 最 后 一 个 细胞 月 






































H grid[i][N-1] 来 访问 。 


第 3 章 Conway 生命 


右 侧 的 邻 
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居 是 grid(iJ[N], (ANGINAL, gridfi][N]Vi 























if j == N-1: 


四 是 一 种 实现 方法 : 


right = grid[i][0] 


else: 


right = grid[i][j+1] 


当然 ， 需 要 在 网 格 的 左 侧 ， 顶 部 和 底部 应 月 














许多 代码 ， 因 为 需要 检测 网 格 的 4 个 边缘 。 更 简洁 
运算 符 ， 如 下 所 示 : 





>>> N = 16 
>>> i1 = 14 
>>> i2 = 15 
>>> (i1+1)%N 
15 

>>> (12+1)%N 
0 


UREE IL, MEF 




















返 ， 像 这 样 重 写 网 格 访问 代码 : 


right = grid[i][(j+1)%N 




















问 的 值 应 该 由 grid[i][0] 代 替 。 下 



































类似 的 边界 条 件 ， 但 这 样 做 要 加 入 


的 方式 是 用 Python 的 取 模 (%) 























现在 ， 如 果 一 个 细胞 在 网 格 边 缘 (换言之 ， 如 果 j= N-1)， 用 这 在 








的 细胞 就 会 得 到 G +1) 




















部 做 同样 的 事 ， 它 就 折返 到 顶部 。 


3.3.4 ”实现 规则 
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生命 游戏 的 规则 基于 相仿 
































































































































%N， 这 将 j 设 回 0， 证 网 格 右 侧 卷曲 到 左 侧 。 








符 给 出 整数 除 以 N 的 余数 。 可 以 用 这 个 运算 符 让 值 在 边缘 折 























方法 请 求 右边 
如 果 在 网 格 底 








| 胞 的 ON 或 OFF 数目 。 为 了 简化 这 些 规 则 的 应 
] ， 可 以 计算 出 处 于 ON 状态 的 相 邻 细胞 总 数 。 因 为 ON 状态 的 值 为 255， 所 以 














胞 的 值 求 和 ， 再 除 以 255， 来 获得 ON 细胞 的 数量 。 下 面 是 相 


可 以 对 所 有 相信 
关 的 代码 : 
# apply Conway's rules 
if grid[i, j] == ON: 
o if (total « 2) or (total » 3): 
newGrid[i, j] = OFF 
else: 
if total -- 3: 
e newGrid[i, j] = ON 


EOT, WA 244584 














胞 为 ON 或 多 于 














由 ON 变 成 OFF。@ 行 代码 仅 适 用 于 OFF 细胞 : 如 


该 细胞 就 变 成 ON。 


现在 该 编写 模拟 的 完整 代码 了 。 
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3 个 相 邻 细胞 为 ON， 该 细胞 就 












































果 恰 好 有 3 个 相 邻 细胞 为 ON， 


3.3.5 ”向 程序 发 送 命令 行 参数 





下 面 的 代码 向 程序 发 送 命令 行 参数 : 


S 














# main() function 
def main(): 
# command line argumentss are in sys.argv[1], sys.argv[2], ... 


0000 


# sys.argv[0] is the script name and can be ignored 

# parse arguments 

parser = argparse.ArgumentParser(description="Runs Conway' 
simulation.") 

# add arguments 

parser.add_argument('--grid-size', dest='N', required=Fals 

parser.add argument('--mov-file', dest-'movfile', required 


S Game of Life 


e) 
-False) 


parser.add argument('--interval', dest-'interval', required-False) 


parser.add argument('--glider', action-'store true', requi 
args - parser.parse args() 


red-False) 














main() 函 数 首先 定义 了 程序 的 命令 行 参 数 。 在 @ 行 ， 月 


命令 行 选项 , 然后 在 接 下 来 几 行 中 添加 各 种 选项 。 在 @ 行 ， 
在 卓 行 ,指定 保存 .moy 文件 的 名 称 。 OT, REAM LPH eA. (eet, 








} 














H argparse 类 为 代码 添加 
指定 模拟 网 格 的 大 小 N。 
































滑翔 机 图 案 开 始 模 拟 。 


3.3.6 ”初始 化 模拟 








继续 看 代码 ， 接 下 来 一 段 ， 对 模拟 初始 化 : 


# set grid size 

N= 100 

if args.N and int(args.N) > 8: 
N = int(args.N) 











# set animation update interval 
updateInterval = 50 
if args.interval: 

updateInterval = int(args.interval) 


# declare grid 
grid = np.array([]) 
# check if "glider" demo flag is specified 
if args.glider: 
grid = np.zeros(N*N).reshape(N, N) 
addGlider(1, 1, grid) 
else: 
# populate grid with random on/off - more off than on 
grid = randomGrid(N) 


Vite main0 函 数 内 ， 命 令 行 选 项 解析 后 ， 这 部 分 代码 应 用 命令 行 传 入 的 所 有 参 
数 。 例 如 ，@ 行 后 的 几 行 设置 初始 条 件 ， 要 么 是 ES 























案 。 最 后 ， 设 置 动 画 。 

















第 


默认 的 随机 图 案 ， 要 么 是 滑翔 机 图 
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# set up the animation 












































o fig, ax = plt.subplots() 
img = ax.imshow(grid, interpolation='nearest' ) 
@ ani = animation.FuncAnimation(fig, update, fargs=(img, grid, N, ), 
frames=10, 
interval-updateInterval, 
save count-50) 
# number of frames? 
# set the output file 
if args.movfile: 
ani.save(args.movfile, fps-30, extra args-['-vcodec', 'libx264']) 
plt.show() 
在 @ 行 , 配置 matplotlib 的 绘图 和 动画 参数 ,。 TE T. animation.FuncAnimation() 
调用 函数 update0， 该 函数 在 前 面 的 程序 中 定义 ， 根 据 Conway 生命 游戏 的 规则 ， 
采用 环形 边界 条 件 来 更 新 网 格 。 


























3.4 完整 代码 




















下 面 是 生命 模拟 游戏 的 完整 程序 .也 可 以 从 https://github.con/electronut/pp/blob/ 


master/conway/conway.py 下 载 该 项 目的 代码 。 


import sys, argparse 

import numpy as np 

import matplotlib.pyplot as plt 

import matplotlib.animation as animation 


ON 
OFF 


= 255 


= 0 


vals = [ON, OFF] 


def 


def 


randomGrid(N): 
"""returns a grid of NxN random values""" 
return np.random.choice(vals, N*N, p-[0.2, 0.8]).reshape(N, N) 


addGlider(i, j, grid): 
"""adds a glider with top-left cell at (i, j)""" 
glider = np.array([[0, 0, 255], 
[255, 0, 255], 
[0, 255, 255]]) 
grid[i:i+3, j:j+3] = glider 


update(frameNum, img, grid, N): 

# copy grid since we require 8 neighbors for calculation 

# and we go line by line 

newGrid = grid.copy() 

for i in range(N): 

for j in range(N): 

# compute 8-neghbor sum using toroidal boundary conditions 
# x and y wrap around so that the simulation 
# takes place on a toroidal surface 
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total = int((grid[i, (j-1)%N] + grid[i, (j+1)%N] + 
grid[(i-1)%N, j] + grid[ (i+1)%N, j] + 
grid[(i-1)%N, (j-1)%N] + grid[(i-1)%N, (j+1)%N] + 
grid[ (it1)%N, (j-1)%N] + grid[ (i+1)%N, (j+1)%N])/255) 

# apply Conway's rules 

if grid[i, j] == ON: 

if (total < 2) or (total > 3): 
newGrid[i, j] = OFF 

else: 

if total == 
newGrid[i, j] = ON 


# update data 
img.set_data(newGrid) 
grid[:] = newGrid[:] 
return img, 


# main() function 
def main(): 
# command line arguments are in sys.argv[1], sys.argv[2], 
# sys.argv[0] is the script name and can be ignored 
# parse arguments 
parser = argparse.ArgumentParser(description-"Runs Conway's Game of Life 
simulation.") 
# add arguments 
parser.add_argument('--grid-size', dest='N', required=False) 
parser.add argument('--mov-file', dest-'movfile', required=False) 
parser.add argument('--interval', dest-'interval', required-False) 
parser.add argument('--glider', action-'store true', required-False) 
parser.add argument('--gosper', action-'store true', required-False) 
args = parser.parse args() 


# set grid size 

N = 100 

if args.N and int(args.N) » 8: 
N = int(args.N) 


# set animation update interval 
updateInterval - 50 
if args.interval: 

updateInterval - int(args.interval) 


# declare grid 
grid = np.array([]) 
# check if "glider" demo flag is specified 
if args.glider: 
grid = np.zeros(N*N).reshape(N, N) 
addGlider(1, 1, grid) 
else: 
# populate grid with random on/off - more off than on 
grid = randomGrid(N) 


# set up the animation 

fig, ax = plt.subplots() 

img = ax.imshow(grid, interpolation='nearest' ) 

ani = animation.FuncAnimation(fig, update, fargs=(img, grid, N, ), 
frames=10, 
interval-updateInterval, 
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save_count=50) 
# number of frames? 
# set the output file 
if args.movfile: 





ani.save(args.movfile, fps-30, extra args-['-vcodec', 'libx264']) 
plt.show() 
# call main 
if name == ' gain 
main() 


3.5 ”运行 模拟 人 生 的 游戏 
现在 运行 代码 : 
$ python3 conway.py 
这 里 采用 模拟 的 默认 参数 : 100X100 个 细胞 的 网 格 ，50 毫秒 的 更 新 闻 隔 。 观 
看 模拟 时 ， 你 会 看 到 它 如 何 进 行 ， 随 着 时 间 的 推移 创建 并 保持 各 种 图 案 ， 如 图 3-4 
所 示 。 


0 





图 3-4 进行 中 的 生命 游戏 


3-5 展示 了 模拟 中 可 以 寻找 的 一 些 图 案 。 除 了 滑翔 机 ， 请 寻找 3 细胞 的 闪光 
灯 ， 以 方块 或 面包 的 形状 等 静态 图 案 。 

现在 ， 改 变 一 下 ， 用 这 些 参数 来 运行 模拟 : 
$ python conway.py --grid-size 32 --interval 500 --glider 

这 创建 了 32x32 的 模拟 网 格 ， 每 500 SPS ero, FORA Wea PLA 
案 ， 如 图 3-5 的 右 下 图 所 示 。 
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方块 面包 


ia" 


闪光 灯 第 2 阶段 ) 滑翔 机 
3-5 ”生命 游戏 中 的 图 案 


3.6 ”小结 





这 个 项 目 探讨 了 Conway 生命 游戏 。 我 们 学 习 了 如 何 基于 某 些 规 则 ， 来 建立 基 
本 的 计算 机 模拟 ， 以 及 如 何 用 matplotlib， 随 着 系统 的 演进 ， 让 系统 的 状态 可 视 化 。 

我 们 的 Conway 生命 游戏 实现 更 强调 简单 ， 而 不 是 性 能 。 有 许多 不 同 的 方式 可 
以 加 快 生命 游戏 的 计算 ， 关 于 如 何 做 到 这 一 点 ， 有 大 量 的 研究 。 快 速 在 互联 网 搜索 
一 下 ， 会 发 现 很 多 这 样 的 研究 。 
















































































3.7 ”实验 























下 面 有 一 些 方法 ， 可 以 进一步 试验 Conway 生命 游戏 。 

1. 编号 addGosperGun0 方 法 ,在 网 格 中 添加 如 图 3-6 所 示 的 图 案 。 这 种 图 案 被 
称 为 “高 斯 帕 滑 翔 机 枪 (Gosper Glider Gun)” 运行 模拟 并 观察 枪 的 行为 。 

2. 编写 readPattern() 方 法 ， 从 文本 文件 读 取 初 始 图 案 ， 并 用 它 来 设置 模拟 的 初 
始 条 件 。 下 面 是 该 文件 的 建议 格式 : 


8 
000 255 ... 
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3-6 高 斯 帕 滑 翔 机 枪 
































该 文件 的 第 一 行 定义 了 N， 其 余部 分 是 NXN 个 整数 (0 或 255)， 由 空格 隔 开 。 
你 可 以 用 Python 的 方法 ， 如 open 和 file.read 来 实现 。 这 种 探索 有 助 于 研究 任何 给 
定 的 图 案 在 生命 游戏 规则 下 是 如 何 演变 的 。 添 加 命令 行 选项 --pattern-file， 在 运行 程 
序 时 使 用 此 文件 。 
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"ds 


用 Karplus-Strong 算法 产生 音乐 泛音 

















任何 乐音 的 主要 特点 是 它 的 音调 , 即 频 率 。 这 是 每 秒 的 振动 
数 ， 单 位 是 赫兹 〈Hz)。 例 如 ， 从 原声 吉他 的 第 三 根 弦 产生 音符 
D, MEE 146.83 赫兹 。 可 以 在 计算 机 上 创建 频率 为 146.83 Hz 
的 正弦 波 ， 来 模拟 这 种 声音 ， 如 图 4-1 Br. 

遗憾 的 是 ,如 果 在 计算 机 上 播放 这 个 正弦 波 ， 听 起 来 不 会 
像 吉他 或 钢琴 。 播放 相同 的 音符 时 , 是 什么 让 计算 机 的 声音 与 
















































































乐器 如 此 不 同 呢 ? 
FE th ESI, 乐器 产生 了 不 同 强度 的 混合 频率 , 如 图 4-2 的 频谱 图 所 示 。 
刚 拨 弦 时 声音 最 强 ， 强 度 随 着 时 间 推 移 而 逐渐 消失 。 拨 动 吉他 D 弱 听 到 的 主要 
频率 称 为 基本 频率 ， 是 146.83 甘 兹 ， 但 也 会 听 到 该 频率 的 一 些 倍数 ， 称 为 泛音 。 
任何 乐器 的 声音 都 由 这 种 基本 频率 和 泛音 组 成 , 正 是 这 种 组 合 ， 让 吉他 听 起 来 像 
吉他 。 

如 你 所 见 ， 在 计算 机 上 模拟 拨 弦 乐器 的 声音 
诀窍 是 利用 Karplus-Strong 算法 。 

这 个 项 目 使 用 Karplus-Strong 算法 ， 产 生 5 个 类 似 吉 他 的 音符 ， 它 们 属于 一 个 
音阶 《一 系列 相关 的 音符 )。 我 们 会 让 产生 这 些 音符 的 算法 可 视 化 ， 并 将 声音 保存 
为 WAN 文件 。 我 们 还 会 创建 一 种 方式 ， 随 机 演奏 它们 ， 并 学 习 如 何 做 到 以 下 几 点 : 

























































































要 能 同时 生成 基本 频率 和 泛音 。 
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e 用 Python 的 deque 类 实现 环形 缓冲 区 ; 
e 使 用 numpy 数组 和 ufuncs; 

e 用 pygame 播放 WAV 文件 ; 

e 用 matplotlib 绘图 ; 

。 演奏 五 声音 阶 。 








图 4-1 146.83 Hz 的 正弦 波 





3000Hz 5000Hz 7000Hz 9000Hz 11000Hz 13000Hz 15000Hz 17000Hz 19000Hz 21000Hz 
图 4-2 吉他 上 弹 奏 音符 D4 的 频谱 图 
除了 用 Python 实现 Karplus-Strong 算法 ， 我 们 还 会 探讨 WAV 文件 格式 ， 看 看 
如 何 产 生 五 声音 阶 中 的 音符 。 


50 Python 极 客 项 目 编程 


4.1 工作 原理 


利用 偏 移 值 构成 的 环形 缓冲 区 , 模拟 两 端 固定 的 弦 , 类 似 于 吉他 弦 , Karplus-Strong 
算法 可 以 模拟 拨 弦 的 声音 。 

环形 缓冲 区 (也 称 为 循环 缓冲 区 ) 是 一 个 固定 长 度 的 缓冲 区 (就 是 值 的 数组 )， 
但 折返 到 本 身 。 换 言 之 ， 如 果 到 达 缓 冲 区 的 末尾 ， 则 下 一 个 元 素 就 是 缓冲 区 的 第 
一 个 元 素 〈 环 缓冲 区 的 更 多 信息 ， 参 见 4.3.1 小 节 )。 
民 据 公式 N=S / f， 环 形 缓冲 区 的 长 度 COND. 与 振动 的 基本 频率 有 关 ， 其 中 5 是 
采样 率 ，f 是 频率 。 

模拟 开始 时 ， 缓 冲 区 中 填充 一 些 随 机 值 ， 范 围 在 [-0.5，0.5]， 可 以 认为 代表 了 
拨 弦 在 振动 时 的 随机 偏 移 。 

除了 环形 缓冲 区 ， 可 以 用 一 个 样本 缓冲 区 ， 保 存 任何 特定 时 间 的 声音 强度 。 这 
个 缓冲 区 的 长 度 和 采样 率 决 定 了 声音 片段 的 长 度 。 
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4.1.1 模拟 





模拟 持续 进行 ， 直 到 样本 缓冲 填充 了 一 种 反馈 方案 ， 如 图 4-3 所 示 。 对 于 模拟 
的 每 一 步 ， 做 以 下 几 件 事 : 
将 环形 缓冲 区 的 第 一 个 值 存 入 样本 缓冲 区 
计算 环形 缓冲 区 前 两 个 元 素 的 平均 值 ; 
平均 值 乘 以 一 个 衰减 系数 〈 在 这 个 例子 中 ， 是 0.995); 
.将 该 值 添加 到 环形 缓冲 区 的 末尾 ; 
. 移 除 环形 缓冲 区 的 第 一 个 元 素 。 


样本 缓冲 区 
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tl t2... 








popleft() 环形 缓冲 区 


+E 
| 均值 *0.995 | 
图 4-3 环形 缓冲 区 和 Karplus-Strong 算法 
为 了 模拟 拨 弦 ， 在 环形 缓冲 区 填 入 一 些 数 字 ， 代 表 波 的 能 量 。 样 本 缓冲 区 表示 
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的 值 来 创建 。 使 用 平均 方案 (等 一 下 








最 终 的 声音 数据 ， 通 过 迭代 遍历 环形 缓冲 区 














这 种 反馈 方案 则 在 模拟 能 量 通过 一 根 振动 的 敬 。 根 据 物理 学 ， 对 于 一 根 振动 的 
弦 ， 基 本 频率 与 它 的 长 度 成 反比 。 因 为 我 们 感 兴趣 的 是 产生 一 定 频 率 的 声音 ， 所 以 
选择 一 个 环形 缓冲 区 ， 其 长 度 与 该 频率 成 反比 。 模 拟 第 1 步 的 求 平均 值 相当 于 “ 低 
通 滤波 器 ”切断 较 高 频率 ， 并 允许 较 低 频率 通过 ， 从 而 消除 高 次 谐 波 〈 即 基 频 的 
较 大 倍数 )， 因 为 我 们 的 主要 兴趣 是 基 频 。 最 后 ， 用 衰减 因子 来 模拟 波 沿 着 弦 来 区 
传播 的 能 量 损 失 。 
模拟 第 1 步 中 用 到 的 样本 缓冲 区 ,表示 产生 的 声音 随时 间 变 化 的 振幅 ,为 了 
计算 任何 给 定 的 振幅 , 需要 计算 环形 缓冲 区 前 两 个 元 素 的 平均 值 , 结果 乘 以 衰减 
系数 ， 更 新 环形 缓冲 区 。 这 个 计算 的 值 被 添加 到 环形 缓冲 区 的 末尾 ， 并 删除 第 
一 个 元 条 

现在 ,我 们 来 看 看 该 算法 执行 的 一 个 简单 例子 。 下 表 表 示 两 个 连续 时 间 步 又 的 
环形 缓冲 区 。 环 形 缓冲 区 中 的 每 个 值 表示 声音 的 振幅 。 该 缓冲 区 具有 5 个 元 素 ， 它 
们 开始 填充 了 一 些 数 字 。 


时 间 步 又 1 0.1 -0.2 0.3 0.6 -0.5 





















































































































































































































































时 间 步 又 2 -0.2 0.3 0.6 -0.5 - 0.199 

















从 第 1 步 转 到 第 2 步 ， 像 这 样 应 用 Karplus-Strong 算法 。 第 一 行 的 第 一 个 值 0.1 
被 删除 ， 第 1 步 中 所 有 后 续 值 以 相同 顺序 加 入 第 2 行 ， 它 表示 时 间 上 的 第 2 步 。 第 
2 步 的 最 后 一 个 值 是 第 1 步 的 第 一 个 值 和 最 后 一 个 值 的 衰减 平均 值 ， 计 算 方法 是 
0.995x( (0.1+ 20.5) +2) =-0.199. 
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4.1.2 创建 WAV 文件 

波形 音频 文件 格式 (WAV ) 用 于 存储 音频 数据 。 这 种 格式 对 小 的 音乐 项 目 比 较 
方便 ， 因 为 它 简单 ， 不 需要 处 理 复杂 的 压缩 技术 。 
在 最 简单 的 形式 中 ，WAYV 文件 由 一 系列 比特 构成 ， 表 示 在 给 定时 间 点 所 记录 
的 声音 的 振幅 ， 称 为 分 辩 率 。 本 项 目 中 使 用 16 BLA HEAR. WAV 文件 也 有 一 组 采 
样 率 ， 是 音频 每 秒 采 样 或 读 取 的 次 数 。 本 项 目 采 用 44100 $525, BU CD 中 使 用 的 
采样 率 。 让 我 们 用 Python 产生 5 秒 的 220 Hz 正弦 波音 频 片 段 。 首 先 ， 用 这 个 公 
式 表示 正弦 波 : 








































































































































































































A = sin (2nft ) 
这 里 ，A 是 声波 的 振幅 ，f 是 频率 ，t 是 当前 时 间 的 索引 。 现 在 ， 
如 下 : 
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A = sin (2nfi/R) 
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在 这 个 公式 中 , i 是 样本 的 索引 , R 是 采样 率 。 用 这 两 个 方程 ， 可 以 按 如 下 方式 
创建 一 个 200 赫兹 的 正弦 波 WAV 文件 : 


import numpy as np 
import wave, math 


sRate = 44100 
nSamples = sRate * 5 
© x = np.arange(nSamples) /float(sRate) 
@ vals = np.sin(2.0*math.pi*220.0*x) 
© data = np.array(vals*32767, 'int16').tostring() 
file = wave.open('sine220.wav', 'wb') 
O file.setparams((1, 2, sRate, nSamples, 'NONE', 'uncompressed')) 
file.writeframes (data) 
file.close() 


在 @ 行 和 @ 行 , 根据 第 二 个 正弦 波 方程 , 创建 振幅 值 的 numpy HA CL 138. 。 
对 数组 应 用 函数 ， 如 sin0 函 数 ，numpy 数组 是 快速 、 便 捷 的 方式 。 

在 @ 行 , 计算 好 的 、 在 [-1，1] 范 围 的 正弦 波 值 被 放大 为 16 位 值 ， 并 转换 成 字符 
串 ， 以 便 写 入 文件 。 在 @ 行 ,为 WAV 文件 设置 参数 ， 在 这 个 例子 中 ， 是 单 通道 CR 
声 道 )、 两 字 节 (16 位 )、 无 压缩 的 格式 。 图 4-4 展示 了 生成 的 sine220.wav 文件 在 
Audacity 中 的 样子 ，Audacity 是 一 款 免 费 的 音频 编辑 器 。 正 如 预期 的 那样 ， 我 们 看 
到 了 频率 220 赫兹 的 正弦 波 ， 如 果 播 放 该 文件 ， 会 听 到 5 秒 的 220 Hz 音调 。 
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E Project Rate (Hz): Selection Start: (€) End C) Length Audio Position: 
- [44100 f$) | C Snap To [00h 00 m 00.000 s~| 00 h 00 m 05.000 s | 00 h00 m 00.000 s~) 
Click to Zoom In, Shift-Click to Zoom Out Actual Rate: 44100 


4-4 220 Hz 的 正弦 波 


4.1.3 ”小 调 五 声音 

“音阶 ” 是 一 系列 升 高 或 降低 音 高 (频率 ) 的 音符 。“ 音 程 ”是 两 个 音 高 之 癌 的 
差 。 通 常 ， 一 首 音乐 的 所 有 首 符 都 从 特定 音阶 中 选择 。“ 半 音 ” 是 音阶 的 基本 单位 ， 
是 西方 音乐 最 小 的 音程 。 全 音 是 半音 长 度 的 两 倍 。“ 大 调 音阶 ”是 最 常见 的 一 种 音 
阶 ， 间 隔 模 式 是 “全 音 -全 音 -半音 -全 音 -全 音 -全 音 - 半 首 。 
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这 里 ， 我 们 将 快速 进入 五 声音 阶 ， 因 为 我 们 要 产生 这 个 音阶 的 音符 。 本 节 将 告 





























诉 你 ， 我 们 如 何 得 出 程序 中 用 到 的 频率 数字 ， 利 用 Karplus-Strong 算法 来 生成 这 些 


























符 。“ 五 声音 阶 ” 




















gm n 
































阶 中 5 个 音符 的 频率 ， 我 们 ; 








是 五 个 音符 的 音阶 。 例 如 ， 美 国 著 名 的 歌曲 “Oh! Susanna" Wè 
基于 五 声音 阶 的 。 这 种 音阶 的 一 个 变种 是 小 调 五 声音 阶 。 


这 种 音阶 定义 为 音符 序列 “(全 音 + 半 音 ) -全 音 -全 音 -〈 全 音 + 半音 ) -全 音 ”。 




















































































































因此 ，C 小 调 五 声音 阶 包含 音符 C、 降 E、F、G 和 降 B。 表 4-1 列 出 了 小 调 五 声音 
各 用 Karplus-Strong 算法 来 产生 它 〈 这 里 ，C4 表示 钢琴 


























第 4 个 八 度 的 C， 或 习惯 称 为 中 音 C)。 
RAL 小 调 五 声音 阶 的 音符 
音符 频率 ( Hz ) 
C4 261.6 
BEE 311.1 
F 349.2 
G 392.0 
降 B 466.2 


42 所 需 模块 


























本 项 目 将 用 Python 的 wave 模块 来 创建 WAV 格式 的 音频 文件 。 使 用 numpy 数 











组 来 实现 Karplus-Strong 算法 ，| 















































] Python 集合 中 的 deque 类 来 实现 环形 缓冲 区 。 还 





会 用 pygame 模块 来 播放 WAV 文件 。 





43 代码 
MÆ, RNJ 





于 发 实现 Karplus-Strong 算法 所 需 的 各 种 代码 片段 ， 然 后 将 它们 








合并 成 完整 的 程序 。 要 查看 完整 的 项 目 代码 ， 请 直接 跳 到 4.4 节 。 





























4.3.1 用 deque 实现 环形 缓冲 区 











们 将 利用 Python 的 


my HH 


deque #45 























可 想 一 下 ， 前 面 提 到 Karplus-Strong 算法 使 用 环形 缓冲 区 来 生成 一 个 音符 。 我 








(发 音 为 “deck”, 是 Python 的 collections 模块 的 一 





部 分 ), 来 实现 环形 缓冲 区 , 它 





的 开始 〈 头 ) BOR 





























E GE) d 








入 或 





j 一 个 数组 提供 了 专门 的 容器 数据 类 型 。 可 以 从 deque 














HIRR COLA 4-5)。 这 种 插入 和 删除 过 程 是 




















O(1) 或 “常数 时 间 ” 的 操作 ， 这 意味 着 不 论 deque 的 容器 变 得 多 大 ， 它 需要 的 时 间 





都 是 相同 的 。 
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头 尾 
O< 
popleft() append() 
O(1) O(1) 


4-5 使 用 deque 的 环形 缓冲 区 


下 面 的 代码 展示 了 如 何在 Python 中 使 用 deque: 


>>> from collections import deque 
@ >>> d = deque(range(10)) 

>>> print(d) 

deque([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]) 
@ >>> d.append(-1) 

>>> print(d) 

deque([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, -1]) 
© >>> d.popleft() 

0 

>>> print d 

deque([1, 2, 3, 4, 5, 6, 7, 8, 9, -1]) 


在 @ 行 ， 传 入 range(0) 方 法 创建 的 一 个 列表 ， 创 建 了 deque 容器 。 在 @ 行 ， 将 一 
个 元 素 添 加 到 deque RAKE, EOT, M deque 的 头 部 弹出 《删除 ) 第 一 个 元 
素 。 这 两 个 操作 都 很 快 。 



































4.3.2 ”实现 Karplus-Strong 算法 
也 可 以 用 deque 容器 ， 针 对 环形 缓冲 区 ， 实 现 Karplus-Strong 算法 ， 如 下 所 示 : 


# generate note of given frequency 
def generateNote(freq): 

nSamples = 44100 

sampleRate = 44100 

N = int(sampleRate/freq) 

# initialize ring buffer 



































o buf = deque([random.random() - 0.5 for i in range(N)]) 
# initialize samples buffer 

e samples = np.array([0]*nSamples, 'float32') 
for i in range(nSamples): 

e samples[i] = buf[0] 

9 avg = 0.996*0.5*(buf[0] + buf[1]) 


buf . append (avg) 
buf .popleft() 


# convert samples to 16-bit values and then to a string 
# the maximum value is 32767 for 16-bit 

© samples = np.array(samples*32767, ‘int16') 

© return samples.tostring() 


企 @ 行 ， 用 范围 在 [-0.5，0.5] 的 随机 数 来 初始 化 deque. ÆA, ENF 
点 数组 来 保存 声音 采样 。 该 数组 的 长 度 与 采样 率 相 符 , 这 意味 着 将 生成 一 秒 钟 的 
声音 片段 。 
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4.3.3 


fE@{T, deque 的 第 一 个 元 素 被 复制 到 采样 缓冲 区 。 在 @ 行 和 随后 几 行 中 ， 可 

















以 看 到 低 通 滤波 器 和 衰减 在 生效 。 在 @ 行 ，samples 数组 的 每 个 值 乘 以 32767 (16 






























































位 带 符号 整数 的 取 值 范围 是 -32768 一 32,767)， 被 转换 成 16 位 的 格式 。 在 @ 行 ， 它 
被 转换 成 字符 串 表 示 形 式 ， 这 是 wave 模块 的 要 求 ， 我 们 将 用 该 模块 ， 将 这 些 数据 
保存 到 文件 。 

写 WAV 文件 














拥有 音频 数据 后 ， 可 以 用 Python 的 wave 模块 ， 将 其 写 入 WAV 文件 。 














def writeWAVE(fname, data): 


# open file 

file = wave.open(fname, 'wb') 

# WAV file parameters 

nChannels = 1 

sampleWidth = 2 

frameRate = 44100 

nFrames = 44100 

# set parameters 

file.setparams((nChannels, sampleWidth, frameRate, nFrames, 
'NONE', 'noncompressed')) 

file.writeframes(data) 

file.close() 


在 @ 行 ， 创 建 了 一 个 WAV 文件 ， 在 @@ 行 ， 将 参数 设置 为 使 用 单 声 道 、16 位 、 






































无 压缩 的 格式 。 最 后 ， 在 @ 行 ， 将 数据 写 入 文件 。 

















4.3.4 FA pygame 播放 WAV 文件 















































IÆ, H Python 的 pygame 模块 播放 算法 生成 的 WAV 文件 。 pygame 是 用 来 编 


























写 游戏 的 流行 Python 模块 。 它 基于 简单 直接 媒体 层 CSDLO. 库 ， 该 库 是 高 性 能 的 底 
层 库 ， 让 你 能 访问 声音 、 图 形 ， 以 及 计算 机 的 输入 设备 。 









































方便 起 见 ， 我 们 将 代码 封装 在 NotePlayer 类 中 ， 如 下 所 示 : 





# play a WAV file 
class NotePlayer: 


# constructor 
def _ init__(self): 
pygame.mixer.pre_init(44100, -16, 1, 2048) 
pygame.init() 
# dictionary of notes 
self.notes = {} 
# add a note 
def add(self, fileName): 
self.notes[fileName] = pygame.mixer.Sound(fileName) 
# play a note 
def play(self, fileName): 
try: 
self .notes[ fileName] .play() 
except: 
print(fileName + ' not found!') 
def playRandom(self): 
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"""play a random note""" 

index = random.randint(0, len(self.notes)-1 
note - list(self.notes.values())[index] 
note.play() 


) 


在 @ 行 ， 预 先 初始 化 pygame 的 mixer 类 : 44100 的 采样 率 ，16 位 的 有 符号 值 ， 
单 声 道 ， 绥 冲 区 大 小 为 2048。 在 @ 行 ， 创 建 一 个 音符 的 字典 ， 它 针对 文件 名 保存 
pygame 的 声音 对 象 。 接 下 来 ， 在 NotePlayer 的 add0 方 法 中 @， 创 建 声音 对 象 ， 并 





将 它 保存 在 notes 目录 中 。 
请 注意 ， 在 play0 中 @ 行 如 何 使 用 目录 ， 二 






























































播放 与 文件 名 相关 联 的 声音 对 象 。 


playRandom() 方 法 从 已 生成 的 五 个 音符 中 随机 选取 一 个 播放 。 最 后 , 在 @ 行 , randint() 



































从 范围 [0,4] 中 选择 一 个 随机 整数 ， 在 @ 行 从 字 


中 挑选 一 个 





4.3.5 ”main() 方 法 














RH 




















放 。 


现在 看 看 main0) 方 法 ， 它 创建 音符 并 处 理 各 种 命令 行 选项 ， 以 演奏 音符 。 


parser = argparse.ArgumentParser(description="Generating sounds with 




















Karplus String Algorithm") 
# add arguments 


parser.add argument('--display', action='store true', required=False) 
parser.add argument('--play', action-'store true', required=False) 


parser.add argument('--piano', action-'store true', required-False) 


args - parser.parse args() 


# show plot if flag set 

if args.display: 
gShowPlot - True 
plt.ion() 


# create note player 
nplayer - NotePlayer() 


print('creating notes...') 
for name, freq in list(pmNotes.items()): 
fileName = name + '.wav' 


if not os.path.exists(fileName) or args.display: 


data = generateNote(freq) 


print('creating ' + fileName + '...') 
writeWAVE(fileName, data) 

else: 
print('fileName already created. skipping...') 


# add note to player 
nplayer.add(name + '.wav') 


# play note if display flag set 

if args.display: 
nplayer.play(name * '.wav') 
time.sleep(0.5) 


# play a random tune 
if args.play: 
while True: 
try: 
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算法 
类 的 


子 - 























ALD 


如 果 


中 随机 播放 一 个 音符 。 要 让 一 个 音符 序列 听 起 来 更 像 音乐 ， 需 要 在 择 
i J numpy 模块 的 random.choice0 方 法 ， 选 择 随机 的 休止 
上 间隔 的 概率 ， 设 置 之 后 可 以 让 两 拍 的 休止 最 有 可 能 ， 
[能 。 请 试 着 改变 这 些 值 ， 以 创建 自己 的 音乐 风格 ! 


添加 
时 间 
八 拍 


4.4 


nplayer.playRandom() 


# rest - 


1 to 8 beats 
rest = np.random.choice([1, 2, 4, 8], 


1, 
p=[0.15, 0.7, 0.1, 0.05]) 


time.sleep(0.25*rest[0]) 
except KeyboardInterrupt: 


exit() 














首先 ， 


SE 








中 波形 如 何 演变 。ionO 调 | 

















一 个 实例 ,用 
pmNotes 中 定义 。 


] argparse 为 程序 建立 一 些 命 令 行 选项 , 就 像 以 前 
在 @ 行 , 如 果 使 用 了 --display 命令 行 选项 , 就 用 matplotlib 绘图 

















的 项 目 中 讨论 的 一 样 
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fre T, FIFA os.path.exists() 方 法 来 查看 WAV 文件 是 否 已 创建 。 如 果 已 创建 ， 




















过 计算 〈 如 果 多 次 运行 该 程序 ， 这 是 一 个 方便 的 优化 )。 
创建 了 WAV 





计算 好 音符 、 
































文件 后 ， 在 四 行将 该 音符 添加 中 ， 





NotePlayer 子 



































在 @ 行 ， 如果 使 


EH J --display PETEM, MEOH 














休止 符 ， 所 以 在 @ 行 ， 
。 该 方法 还 可 以 选择 休 


的 休止 最 不 可 




















完整 代码 









































放 它 。 











o 


» ZN Karplus-Strong 
动 了 matplotlib 的 交互 模式 。 然 后 , 创建 NotePlayer 
generateNote() 方 法 生成 五 声音 阶 的 音符 。 五 个 音符 的 频率 在 全 局 


] T --play 选项 ,NotePlayer 的 playRandom() 方 法 就 从 五 个 音符 















































现在 将 程序 整合 在 














pp/blob/master/karplus/ks.py 下 载 。 


import SyS，0S 


import time, 


random 


import wave, argparse, pygame 
import numpy as np 


from 


collections import deque 


from matplotlib import pyplot as plt 


# show plot of algorithm in action? 
gShowPlot = False 


# notes of a Pentatonic Minor scale 
# piano C4-E(b) -F-G-B(b)-C5 


pmNotes = {'C4': 262, 'Eb': 311, 'F': 349, 'G':391, 'Bb':466} 
# write out WAV file 
def writeWAVE(fname, data): 

# open file 

file = wave.open(fname, 'wb') 


# WAV file parameters 
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放 的 音符 之 间 





起 。 完整 的 代码 如 下 , 也 可 以 从 https://github.com/electronut/ 


nChannels = 1 

sampleWidth = 2 

frameRate = 44100 

nFrames = 44100 

# set parameters 

file.setparams((nChannels, sampleWidth, frameRate, nFrames, 
'NONE', 'noncompressed')) 

file.writeframes(data) 

file.close() 


# generate note of given frequency 
def generateNote(freq): 
nSamples - 44100 
sampleRate - 44100 
N = int(sampleRate/freq) 
# initialize ring buffer 
buf = deque([random.random() - 0.5 for i in range(N)]) 
# plot of flag set 
if gShowPlot: 
axline, = plt.plot(buf) 
# initialize samples buffer 
samples = np.array([0]*nSamples, 'float32') 
for i in range(nSamples) : 
samples[i] = buf[0] 
avg = 0.995*0.5*(buf[0] + buf[1]) 
buf . append (avg) 
buf .popleft() 
# plot of flag set 
if gShowPlot: 
if i % 1000 == 0: 
axline.set_ydata(buf) 
plt.draw() 


# convert samples to 16-bit values and then to a string 
# the maximum value is 32767 for 16-bit 

samples = np.array(samples*32767, 'intí6') 

return samples.tostring() 


# play a WAV file 
class NotePlayer: 
# constructor 
def _ init__(self): 
pygame.mixer.pre_init(44100, -16, 1, 2048) 
pygame.init() 
# dictionary of notes 
self.notes = {} 


# add a note 
def add(self, fileName): 
self.notes[fileName] = pygame.mixer.Sound (fileName) 


# play a note 
def play(self, fileName): 
try: 
self.notes[ fileName] .play() 
except: 
print(fileName + ' not found!') 
def playRandom(self): 
"""play a random note""" 
index = random.randint(0, len(self.notes)-1) 
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note = list(self.notes.values() ) [index] 
note.play() 


# main() function 

def main(): 
# declare global var 
global gShowPlot 


parser = argparse.ArgumentParser(description-"Generating sounds with 
Karplus String Algorithm") 

# add arguments 

parser.add_argument('--display', action='store_true', required=False) 

parser.add argument('--play', action-'store true', required-False) 

parser.add argument('--piano', action-'store true', required-False) 

args - parser.parse args() 


# show plot if flag set 

if args.display: 
gShowPlot = True 
plt.ion() 


# create note player 
nplayer = NotePlayer() 


print('creating notes...') 
for name, freq in list(pmNotes.items()): 
fileName = name + '.wav' 
if not os.path.exists(fileName) or args.display: 
data = generateNote(freq) 


print('creating ' + fileName + '...') 
writeWAVE(fileName, data) 

else: 
print('fileName already created. skipping...') 


# add note to player 
nplayer.add(name + '.wav') 


# play note if display flag set 

if args.display: 
nplayer.play(name + '.wav') 
time.sleep(0.5) 


# play a random tune 
if args.play: 
while True: 
try: 
nplayer.playRandom() 
# rest - 1 to 8 beats 
rest - np.random.choice([1, 2, 4, 8], 1, 
p=[0.15, 0.7, 0.1, 0.05]) 
time.sleep(0.25*rest[0]) 
except KeyboardInterrupt: 
exit() 


# random piano mode 
if args.piano: 
while True: 
for event in pygame.event.get(): 
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if (event.type == pygame.KEYUP) : 
print("key pressed") 
nplayer.playRandom() 
time.sleep(0.5) 


# call main 
if name == ' gain ': 
main() 





4.5 SH 


运行 这 个 项 目的 代码 ， 就 在 命令 行 输入 : 


$ python3 ks.py —display 


























matplotlib 绘图 展示 了 Karplus-Strong 算法 如 何 转 换 初始 随机 偏 移 ， 创 建 所 需 频 
率 的 波 ， 如 图 4-6 所 示 。 





























karplus Python 80x40 fi mahesh 
moksha:karplus mahesh$ python ks.py --display moksha:~ mahesh$ 


creating Eb.wav.. 
creating Bb.wav.. ME 


Figure 1 
creating G.wav... 

















20 40 


$0O0--485iB 





图 4-6  Karplus-Strong 算法 的 运行 示例 
现在 尝试 用 这 个 程序 播放 随机 音符 。 
$ python ks.py —play 


这 应 该 会 用 生成 的 五 声音 阶 WAV 文 伯 



































S: 














播放 随机 的 音符 序列 。 
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4.6 小 结 











这 个 项 目 用 Karplus-Strong 算法 来 模拟 拨 弦 的 声音 , 利用 生成 的 WAV Sc TE 
放 音 符 。 

















4.7 实验 














这 里 有 一 些 值得 试验 的 想法 : 

1. 用 你 在 本 章 学 到 的 技术 创建 一 种 方法 ， 重 现 两 根 不 同 频率 的 弦 一 起 振动 发 
出 的 声音 。 记 住 ，Karplus-Strong 算法 产生 的 声音 振幅 可 以 闭 加 (放大 到 16 位 值 并 
生成 WAV 文件 之 前 )。 现 在 ， 在 第 一 次 拨 弦 和 第 二 次 拨 驼 之 间 增 加 一 点 延 时 。 

2. 写 一 个 方法 ， 从 文本 文件 中 读 取 首 乐 ， 并 生成 音符 。 然 后 用 这 些 音 符 播放 
音乐 。 使 用 的 格式 可 以 是 音符 名 称 后 面 跟 上 整数 的 休止 时 间 ， 就 像 这 样 : C4 1 F4 2 





















































































































































3. 为 项 目 添加 --piano 命令 行 选项 。 如 果 程 序 用 这 个 选项 运行 ， 用 户 应 该 能 够 
按键 盘 上 的 A、S、D、F 和 G 键 ， 播 放 五 个 音符 〈 提 示 : 用 pygame.eventget 和 
pygame.event.type )。 
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"Os 


RE: 仿真 鸟 群 








仔细 观察 一 群 鸟 或 一 群 鱼 ， 你 会 发 现 ， 虽 然 群 体 由 个 体 生 
物 组 成 ， 但 该 群体 作为 一 个 整体 似乎 有 它 自 己 的 生命 。 鸟 群 
的 鸟 在 移动 、 飞 越 和 绕 过 障碍 物 时 ， 彼 此 之 间 相 互 定位 。 受 到 
打扰 或 惊吓 时 会 破坏 编队 ， 但 随后 重新 集结 ， 仿 佛 被 某 种 更 大 
的 力量 控制 。 

1986 Æ, Craig Reynolds 创造 鸟 类 群体 行为 的 一 种 逼真 模拟 ， 
称 为 “类 鸟 群 (Boids)” 模 型 。 关 于 类 鸟 群 模型 ， 值 得 注意 的 是 ， 只 有 3 个 简单 的 
规则 控制 着 群体 中 个 体 间 的 相互 作用 ， 但 该 模型 产生 的 行为 类 似 于 真正 的 鸟 群 。 类 
鸟 群 模型 被 广泛 研究 ， 甚 至 被 Leti fei PSE TT SEL ZN I, dA "spi DUKE 
(1992)” PAY{T 2E 4885. 

本 项 目 将 利用 Reynolds 的 3 个 规则 ， 创 建 一 个 类 鸟 群 ， 模 拟 N 只 鸟 的 群体 
行为 , 并 画 出 随 着 时 间 的 推移 , 它们 的 位 置 和 运动 方向 。 我们 还 会 提供 一 个 方法 ， 
向 鸟 群 中 添加 一 只 鸟 ， 以 及 一 种 驱散 效果 ， 可 以 用 于 研究 群体 的 局 部 干扰 效果 。 
类 鸟 群 被 称 为 “N 体 模拟 ” 因为 它 模拟 了 N 个 粒子 的 动态 系统 ， 彼 此 之 间 施 加 































































































































































































































































































































































































5.1 工作 原理 
模拟 类 鸟 群 的 三 大 核心 规则 如 下 : 
4) BS, 保持 类 鸟 个 体 之 间 的 最 小 距离 ; 
列队 : 让 每 个 类 鸟 个 体 指 向 其 局 部 同伴 的 平均 移动 方向 ; 





















































AR: 让 每 个 类 乌 个 体 朝 其 局 部 同伴 的 质量 中 心 移动 。 
类 乌 群 模拟 也 可 以 添加 其 他 规则 ， 如 避 开 障碍 物 ， 或 受到 打扰 时 驱散 乌 群 , 在 
随后 的 小 节 中 我 们 将 会 探讨 这 些 。 这 个 版 本 的 类 乌 群 在 模拟 的 每 一 步 中 , 实现 了 这 






























































些 核 心 规则 。 
© 对 于 群体 中 的 所 有 类 鸟 个体 ， 做 以 下 几 件 事 ; 
。 应 用 三 大 核心 规则 ; 
。 应 用 所 有 附加 规则 ; 
€ 应 用 所 有 边界 条 件 。 





























。 更 新 类 乌 个 体 的 位 置 和 速度 。 
。 绘制 新 的 位 置 和 速度 。 
如 你 所 见 ， 这 些 简单 的 规则 创造 了 一 个 乌 群 ， 它 具有 演变 的 复杂 行为 。 

















5.2 ”所 需 模 块 
下 面 是 该 模拟 要 
numpy 数组 ， 月 
matplotlib JÆ, 





























到 的 Python 工具 : 
于 保存 类 鸟 群 的 位 置 和 速度 ; 

于 生成 类 鸟 群 动画 ; 

于 处 理 命 令 行 选项 ; 

scipy.spatial.distance 模块 ， 包 含 一 些 非常 简洁 的 方法 ， 计 算 点 之 间 的 距离 。 











au 















































iz 





argparse, 




















注意 FX LRA, RAMA matplotlib， 是 为 了 简单 和 方便 。 要 尽 可 能 快 地 
绘制 数量 庞大 的 类 乌 群 ， 可 能 会 使 用 类 似 OpenGL 这 样 的 库 。 本 书 的 第 三 部 分 
将 详细 探讨 图 形 。 
5.3 ”代码 
首先 ， 要 计算 类 鸟 群 的 位 置 和 速度 。 接 下 来 ， 要 为 模拟 设置 边界 条 件 ， 看 看 如 
































何 绘制 类 乌 群 ， 并 实现 前 面 讨论 的 类 乌 群 模拟 规则 。 最 后 ， 我 们 会 为 模拟 添加 一 些 





























5 





EE 5.4 节 。 
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有 趣 的 事件 ， 即 添加 一 些 类 乌 个 体 和 了 驱散 类 乌 群 。 要 查看 完整 的 项 








目 代 码 ， 请 直接 




















5.3.1 计算 类 鸟 群 的 位 置 和 速度 
类 乌 群 仿真 需要 从 numpy 数组 取得 信息 , 计算 每 一 步 中 类 乌 群 个 体 的 位 置 和 速 
度 。 模 拟 开始 时 ， 将 所 有 类 乌 群 个 体 大 致 放 在 屏幕 中 央 ， 速 度 设 置 为 随机 的 方向 。 


© import math 
@ import numpy as np 









































© width, height = 640, 480 


O pos = [width/2.0, height/2.0] + 10*np.random.rand(2*N).reshape(N, 2) 
© angles = 2*math.pi*np.random.rand(N) 
@ vel = np.array(list(zip(np.sin(angles), np.cos(angles)))) 


开始 在 @ 行 导入 math 模块 ， 用 于 接 下 来 的 计算 。 在 @ 行 ， 将 numpy EFA 
为 np( 少 一 些 录 入 )。 然 后 ， 设 置 屏幕 上 模拟 窗口 的 宽度 和 高 度 @。 在 @ 行 ， 创 
建 一 个 numpy 数组 pos， 对 窗口 中 心 加 上 10 个 单位 以 内 的 随机 偏 移 。 代 码 
np.random.rand (2 * N) 创建 了 一 个 一 维 数组 , 包含 范围 在 [0, 1] 的 2N 个 随机 数 。 
然后 reshape(O 调 用 将 它 转 换 成 二 维 数组 的 形状 CN，2)， 它 将 用 于 保存 类 乌 群 个 
体 的 位 置 。 也 要 注意 ，numpy 的 广播 规则 在 这 里 生效 : 1X2 的 数组 加 到 NX2 的 
数组 的 每 个 元 素 上 。 

接 下 来 , 用 以 下 方法 , 创建 随机 单位 速度 矢量 数组 (这 些 都 是 模 为 1.0 的 矢量 ， 
指向 随机 的 方向 ); 给 定 一 个 角度 t， 数 字 对 (cos(b, sin(t)) 位 于 半径 为 1.0 WEE, 
中 心 在 原点 (0, 0)。 如 果 从 原点 到 圆 上 的 一 点 画 一 条 线 ， 就 得 到 一 个 单位 矢量 ， 它 
取决 于 角度 A。 如 果 随 机 选择 角度 A， 就 得 到 一 个 随机 速度 矢量 。 图 5-1 展示 了 
这 个 方案 。 
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(cos(t2), sin(t2]) 


LN sin(r1]) 


5-1 随机 生成 单位 速度 矢量 


在 @ 行 ， 生 成 一 个 数组 ， 包 含 N 个 随机 角度 ， 范 围 在 [0, 2pi]， 在 @ 行 ， 用 前 面 
讨论 的 随机 向 量 方法 生成 一 个 数组 ,并 用 内 置 的 zip0 方 法 将 坐标 分 组 。 这 里 有 zipO 
的 一 个 简单 例子 。 它 将 两 个 列表 合并 成 一 个 元 组 的 列表 。 
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>>> zip([0, 1, 2], [3, 4, 5]) 
[(0, 3), (1; 4), (2, 5)] 


这 里 ， 生 成 了 两 个 数组 ， 一 个 包含 随机 的 位 置 ， 聚 集 在 屏幕 中 心 10 像素 的 半 








[ 


径 范 围 内 ， 另 一 个 包含 随机 方向 的 单位 速度 。 这 意味 着 在 模拟 开始 时 ， 类 乌 群 盘旋 








在 屏幕 中 心 ， 指 向 随机 的 方向 。 


5.3.2 ”设置 边界 条 件 
乌 儿 飞翔 在 无 际 的 天 空 , 但 类 乌 群 必须 在 有 限 的 空间 中 运动 。 要 

















创建 这 个 空间 ， 





就 要 创建 边界 条 件 ， 就 像 第 3 章 中 为 Conway 模拟 创建 环形 边界 条 伯 
































一 样 。 在 这 个 


例子 中 ， 我 们 采用 “ 平 铺 小 块 边界 条 件 ”( 实 际 上 是 第 3 章 中 使 用 的 边界 条 件 的 连 





续 空间 版 本 )。 





将 类 乌 群 模拟 想象 成 发 生 在 一 个 平 铺 的 空间 : 如 果 类 乌 群 个 体 离开 一 个 小 块 ， 























它 将 从 相反 的 方向 进入 到 相同 的 小 块 。 环形 边界 条 件 和 小 块 边界 条 们 














F 之 间 的 主要 区 


别 是 ， 类 乌 群 模拟 不 会 发 生 在 离散 的 网 格 上 ， 而 是 在 一 个 连续 区 域 移动 。 图 5-2 展 





示 了 这 些小 块 边界 条 件 的 样子 。 请 看 图 5-2 PIAA DSR. RA UA SS LIE BEA 



































边 的 小 块 ， 但 该 边界 条 件 确保 它们 实际 上 通过 平 铺 在 左边 的 小 块 ， 又 回 到 了 中 心 的 


小 块 。 在 顶部 和 底部 的 小 块 ， 可 以 看 到 同样 的 事情 发 生 。 





E 
E 
4s 


E 5-2 平 铺 小 块 边界 条 件 
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下 面 是 如 何 为 类 乌 群 模拟 实现 平 铺 小 块 边界 条 件 : 


def applyBC(self): 
"""apply boundary conditions""" 
deltaR = 2.0 
for coord in self.pos: 
o if coord[0] > width + deltaR: 
coord[0] = - deltaR 
if coord[0] < - deltaR: 
coord[0] = width + deltaR 
if coord[1] > height + deltaR: 
coord[1] = - deltaR 
if coord[1] < - deltaR: 
coord[1] = height + deltaR 


在 @ 行 ， 如 果 x 坐标 比 小 块 的 宽度 大 ， 则 将 它 设 置 回 小 块 的 左 侧 边 缘 。 该 行 中 
的 deltaR 提供 了 一 个 微小 的 缓冲 区 ， 它 允许 类 乌 群 个 体 开 始 从 相反 方向 回来 之 前 ， 
稍稍 移出 小 块 之 外 一 点 ， 从 而 产生 更 好 的 视觉 效果 。 在 小 块 的 左 侧 、 项 部 和 底部 边 
缘 执行 类 似 的 检查 。 

















5.3.3 ”绘制 类 鸟 群 
要 生成 动画 ， 需 要 知道 类 鸟 群 个 体 的 位 置 和 速度 ， 并 有 办 法 在 每 个 时 间 步 又 中 
表示 位 置 和 运动 方向 。 
1. 绘制 类 鸟 群 个 体 的 身体 和 头 部 


为 了 生成 类 鸟 群 动画 ， 我 们 用 matplotlib 和 一 点 小 技巧 来 绘制 位 置 和 速度 。 将 
每 个 类 鸟 群 个 体 画 成 两 个 圆 ， 如 图 5-3 所 示 。 较 大 的 圆 代 表 身 体 ， 较 小 的 圆 表示 头 
部 点 P 是 身体 的 中 心 , 五 是 头 部 的 中 心 。 根据 公式 五 =P+kxV 来 计算 五 的 位 置 ， 
其 中 冯 是 类 鸟 群 个 体 的 速度 , 大 是 常数 。 在 任何 给 定时 间 ， 类 鸟 群 个 体 的 头 指 向 j 
动 的 方向 。 这 指明 了 类 鸟 群 个 体 的 移动 方向 ， 比 只 画 身 体 更 好 。 
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ax 


乌 群 个 体 的 身体 。 








ep ic el H 





bau 


在 下 面 的 代码 片段 中 ， 利 用 matplotlib, JE 


fig = plt.figure() 
ax = plt.axes(xlim=(0, width), ylim=(0, height) ) 














o pts, = ax.plot([], [], markersize-10, c='k', marker='o', ls-'None') 
e beak, = ax.plot([], [], markersize-4, c-'r', marker-'o', ls-'None') 
e anim - animation.FuncAnimation(fig, tick, fargs-(pts, beak, boids), 


interval-50) 
在 @ 和 各行 分 别 为 类 鸟 群 个 体 的 身体 (pts) 和 头 部 Cbeak) 标记 设置 大 小 和 形 
状 。 在 @ 行 为 动画 窗口 添加 鼠标 按钮 事件 。 既 然 知 道 了 如 何 绘制 身体 和 吃 ， 让 我 们 
看 看 如 何 更 新 它们 的 位 置 。 
2. 更 新 类 鸟 群 个 体 的 位 置 


动画 开始 后 ， 需 要 更 新 身体 和 头 的 位 置 ， 它 指明 了 类 乌 群 个 体 移 动 的 方向 。 用 
以 下 代码 来 实现 : 


© vec = self.pos + 10*self.vel/self.maxVel 
@ beak.set_data(vec.reshape(2*self.N)[::2], vec.reshape(2*self.N)[1::2]) 


在 @ 行 ， 计 算 头 部 的 位 置 ， 即 在 速度 (vel)〉 的 方向 上 增加 10 个 单位 的 位 移 。 
该 位 移 确 定 了 吃 和 身体 之 间 的 距离 。 在 @@ 行 ， 用 头 部 位 置 的 新 值 来 更 新 (reshape 
matplotlib 的 轴 (set_data)。[::2] 从 速度 列表 中 选 出 偶数 元 素 Cx 轴 的 值 )，[1::2] 选 出 
奇数 元 素 CY 轴 的 值 )。 










































































































































































5.3.4 ”应 用 类 鸟 群 规 则 
现在 ， 要 在 Python 中 实现 类 鸟 群 的 3 个 规则 。 我 们 用 “numpy 的 方式 ”来 完成 
这 件 事 ， 避 免 循环 并 利用 高 度 优化 的 numpy 方法 。 


import numpy as np 
from scipy.spatial.distance import squareform, pdist, cdist 




































































def test2(pos, radius): 
# get distance matrix 


o distMatrix = squareform(pdist(pos)) 
# apply threshold 
e D - distMatrix « radius 
# compute velocity 
e vel = pos*D.sum(axis-1).reshape(N, 1) - D.dot(pos) 


return vel 
































企 @ 行 ， 用 squareform()#ll pdist0 方 法 (在 scipy 库 中 定义 ), 来 计算 一 组 点 之 间 
两 两 的 距离 (从 数组 中 任意 取 两 点 , 计算 距离 , 然后 针对 所 有 可 能 的 两 点 对 这 么 做 )。 
例如 ， 在 下 面 代 码 中 ， 有 3 个 点 ， 这 意味 着 3 种 可 能 两 点 对 : 


>>> import numpy as np 
>>> from scipy.spatial.distance import squareform, pdist 
>>> x = np.array([[0.0, 0.0], [1.0, 1.0], [2.0, 2.0]]) 
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>>> squareform(pdist (x) ) 

array([[ 0. , 1.41421356, 2.82842712], 
[ 1.41421356, 0. , 1.41421356], 

[ 2.82842712, 1.41421356, 0. ]]) 


squareform( 7; 1525 t —4 3X3 ARP, 其 中 项 Mi 给 出 了 点 Pi 和 Pj 之 间 的 距离 。 
接 下 来 ， 在 @ 行 ， 基 于 距离 筛选 这 个 窍 阵 。 使 用 同样 的 3 点 的 例子 ,得 到 如 下 结果 : 


>>> squareform(pdist(x)) < 1.4 
array([[ True, False, False], 

[False, True, False], 
[False, False, True]], dtype-bool) 


“<” EREE A hFE ERE GX MBIT PE 1.4) WAEA, WEDB 
阵 的 项 。 这 种 其 凑 的 方式 表达 了 你 想 要 的 结果 ， 更 接近 实际 的 思考 方式 。 

在 目 行 的 方法 有 点 复杂 。D.sum(0 方 法 按 列 对 和 矩阵 中 的 True 值 求 和 。reshape 是 
必需 的 ， 因 为 和 是 N 个 值 的 一 维 数组 ( 形 如 NN，))， 而 你 希望 它 形 如 (N，1), 这 
样 它 就 能 够 与 位 置 数组 相 乘 。D.dot0) 就 是 矩阵 和 位 置 矢 量 的 点 积 CFE). 

test2 比 test] 的 小 得 多 ， 但 它 真 正 的 优势 是 速度 。 让 我 们 用 Python timeit 模块 
来 比较 前 面 两 种 方法 的 性 能 。 下 面 的 代码 写 在 Python 解释 器 中 ， 假 设 函 数 test] 和 
test2 的 代码 在 同一 目录 下 的 test.py 文件 中 : 


>>> from timeit import timeit 

>>> timeit('testi(pos, 100)', ‘from test import test1, N, pos, width, height', 
number=100) 

7 . 880876064300537 

>>> timeit('test2(pos, 100)', 'from test import test2, N, pos, width, height', 
number=100) 

0.036969900131225586 


在 我 的 计算 机 上 ， 没 有 循环 的 numpy 代码 比 
但 为 什么 呢 ? 它们 不 是 差不多 都 是 一 回 事 吗 ? 
原因 在 于 ， 作 为 一 种 解释 型 语言 ，Python 天 生 就 比 C 语言 这 样 的 编译 语言 慢 。 
numpy 库 提 供 了 高 度 优化 的 数组 操作 方法 ， 带 来 了 Python 的 方便 和 几乎 C 语言 相 
等 的 性 能 (你 会 发 现 ， 如 果 重 新 组 织 算法 ， 每 次 操作 整个 数组 ， 不 要 循环 单个 元 素 
来 进行 计算 ， 这 样 numpy 的 效果 最 好 )。 
下 面 的 方法 利用 前 面 讨论 的 numpy 技术 ， 应 用 类 乌 群 的 3 个 规则 : 
def applyRules(self): 
# apply rule #1: Separation 
D = distMatrix < 25.0 


vel = self.pos*D.sum(axis=1).reshape(self.N, 1) - D.dot(self.pos) 
self.limit(vel, self.maxRuleVel) 
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# distance threshold for alignment (different from separation) 
D = distMatrix « 50.0 


# apply rule #2: Alignment 
vel2 - D.dot(self.vel) 
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5.3.5 


self.limit(vel2, self.maxRuleVel) 
vel *- vel2; 


# apply rule #3: Cohesion 














































































































o vel3 - D.dot(self.pos) - self.pos 
self.limit(vel3, self.maxRuleVel) 
vel += vel3 
return vel 
在 @@ 行 应 用 分 离 规则 时 ， 每 个 个 体 都 被 “ 推 离 ” 相 邻 个 体 一 定 距离 ， 正 如 本 节 
开始 时 的 讨论 。 在 @ 行 ， 计 算出 的 速度 被 限制 在 某 个 最 大 值 以 内 没有 这 项 检查 ， 
值 将 随 着 每 个 时 间 步 又 增加 ， 模 拟 将 失控 )。 
在 四 行 应 用 列队 规则 时 ，50 个 单位 的 半径 内 ， 所 有 相 邻 个 体 的 速度 之 和 限制 为 
一 个 最 大 值 。 这 样 做 是 为 了 计算 的 最 后 速度 不 会 无 限 增加 。 因 此 , 任何 给 全 定 的 个 体 ， 
都 会 受到 指定 半径 内 个 体 的 平均 速度 影响 ,并 据 此 列队 (利用 紧凑 的 numpy 语法 做 





























这 种 计算 ， 让 事情 变 得 简单 、 快 捷 。) 


最 后 ， 在 @ 行 应 用 内 聚 规则 ， 


径 内 相 
的 语法 。 


添加 个 体 


类 


程 中 添加 一 个 个 体 ， 看 看 表现 如 何 ， 计 
下 面 的 代码 创建 一 个 鼠标 事件 ， 让 你 点 


邻 个 体 的 重心 或 几何 中 心 。 利 ) 





























布尔 距 








类 鸟 群 模拟 的 核心 规则 会 导致 类 鸟 大 


为 每 个 个 体 增加 一 个 速度 矢量 ， 
E ES 42 RA numpy f 











(A ER 









































在 光标 的 位 置 ， 具 有 随机 指定 的 速度 。 


# add a " 
o cid - fig.canvas.mpl connect('button press event', 





button press" event handler 





(E01; , 









































上 事情 


mpl_connect(0 方 法 向 matplotlib Hi4 
在 模拟 窗口 按 下 鼠标 时 ，buttonPress() 方 法 都 会 被 ; 








变 得 更 有 趣 。 
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x BRE Ze ES AIL — T RS AREA 


buttonPress) 


它 指向 一 定 半 
的 方法， 实现 紧凑 


行为 。 但 是 ， 让 我 们 在 模拟 过 











6 添加 一 个 按钮 按 下 事件 。 





现在 ， 为 了 处 理 鼠 标 事件 ， 实际 创建 类 鸟 群 个 体 ， 添加 以 下 代码 ; 


def 


buttonPress(self, event): 


""event handler for matplotlib button presses""" 
# left-click to add a boid 
o if event.button is 1: 


self.pos = np.concatenate((self.pos, 


np.array([[event.xdata, event.ydata]])), 


axis-0) 
# generate a random velocity 


angles - 2*math.pi*np.random.rand(1 
v = np.array(list(zip(np.sin(angles), 


self.vel = np.concatenate((self.vel, v), axis=0) 


self.N += 1 
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np.cos(angles)))) 


的 鼠标 位 置 添加 到 类 鸟 群 的 位 置 数组 。 在 目 行 和 随后 的 行 中 ， 将 一 个 随机 速度 矢量 














在 @ 行 ， 确 保 鼠 标 事 件 是 左 键 点 击 。 在 @ 行 ， 将 (event.xdata，event.ydata) 给 出 



































添加 到 类 鸟 群 的 速度 数组 ， 并 将 类 鸟 群 的 计数 增加 1. 








5.3.6 ”驱散 类 鸟 群 


3 个 模拟 规则 保持 类 乌 群 在 移动 时 成 为 一 个 群体 。 但 是 ， 群 体 受 到 惊扰 时 ， 会 





























发 生 什 么 ”为 了 模拟 这 种 情况 ， 可 以 引入 一 种 “驱散 ”效果 : 如 果 在 用 户 界面 (UI) 



































窗口 中 单 击 右 键 ， 群 体 就 会 分 散 。 你 可 以 认为 这 是 群体 面 对 突然 出 现 的 捕食 者 的 有 反 
应 ， 或 突然 出 现 一 声 巨 响 惊吓 了 鸟 群 。 下 面 是 实现 该 效果 的 一 种 方式 ， 它 作为 
buttonPress() 方 法 的 延续 : 









































# right-click to scatter boids 
elif event.button is 3: 
# add scattering velocity 
self.vel += 0.1*(self.pos - np.array([[event.xdata, event.ydata]])) 


在 @ 行 ， 检 查 鼠 标 按键 是 否 是 右键 单 击 事件 。 在 @@ 行 ， 改 变 每 个 个 体 的 速度 ， 





























在 干扰 出 现 的 点 〈“ 即 点 击 鼠 标的 位 置 ) 的 相反 的 方向 上 增加 一 个 分 量 。 最 初 ， 类 乌 
群 将 飞 离 该 点 ， 但 你 会 看 到 ，3 个 规则 胜出 ， 类 乌 群 将 作为 群体 再 次 会 聚 。 


























5.3.7 命令 行 参数 











下 面 是 类 乌 群 程序 如 何 处 理 命令 行 参 数 : 


parser = argparse.ArgumentParser(description-"Implementing Craig 
Reynolds's Boids...") 

















# add arguments 
parser.add_argument('--num-boids', dest='N', required=False) 
args = parser.parse_args() 


# set the initial number of boids 
N = 100 
if args.N: 

N = int(args.N) 


# create boids 
boids = Boids(N) 


main() 方 法 首先 在 @ 行 设置 了 一 个 命令 行 选 项 ， 使 用 我 们 熟悉 的 argparse 模块 。 











5.3.8 Boids 类 


接 下 来 看 看 Boids 类 ， 它 代表 了 模拟 。 

















class Boids: 


"""class that represents Boids simulation"'"" 
def init__(self, N): 

"""initialize the Boid simulation""" 

# initial position and velocities 
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o self.pos = [width/2.0, height/2.0] + 10*np.random.rand(2*N).reshape(N, 2) 
# normalized random velocities 
angles - 2*math.pi*np.random.rand(N) 
self.vel = np.array(list(zip(np.sin(angles), np.cos(angles)))) 
Self.N =N 
# minimum distance of approach 
self.minDist = 25.0 
# maximum magnitude of velocities calculated by "rules" 
self .maxRuleVel = 0.03 
# maximum magnitude of the final velocity 
self.maxVel = 2.0 


Boid 类 处 理 初始 化 ， 更 新 动画 ， 并 应 用 规则 。 在 @ 行 和 随后 的 行 中 ， 初 始 化 位 
置 和 速度 数组 。 
boids.tick0 在 每 个 时 间 步 又 被 调用 ， 以 便 更 新 动画 ， 如 下 所 示 : 


def tick(frameNum, pts, beak, boids): 
#print frameNum 
"""update function for animation""" 
boids.tick(frameNum, pts, beak) 
return pts, beak 


我 们 还 需要 一 种 方法 来 限制 某 些 矢量 的 值 。 否 则 ， 速 度 将 在 每 个 时 间 步 又 无 限 
制 地 增加 ， 模 拟 将 裔 省。 


def limitVec(self, vec, maxVal): 
"""limit the magnitude of the 2D vector""" 
mag = norm(vec) 
if mag > maxVal: 
vec[0], vec[1] = vec[0]*maxVal/mag, vec[1]*maxVal/mag 

















































































































o def limit(self, X, maxVal): 
"""limit the magnitude of 2D vectors in array X to maxValue""" 
for vec in X: 
self.limitVec(vec, maxVal) 


frei MT dmitQZ71k, Bill TX 























的 值 ， 采 用 模拟 规则 计算 出 的 值 。 


























5.4 完整 代码 


下 面 是 类 乌 群 模拟 的 完整 程序 。 也 可 以 从 https://github.com/electronut/pp/blob/ 
master/boids/boids.py 下 载 该 项 目的 代码 。 


import sys, argparse 

import math 

import numpy as np 

import matplotlib.pyplot as plt 

import matplotlib.animation as animation 

from scipy.spatial.distance import squareform, pdist, cdist 
from numpy.linalg import norm 





























width, height = 640, 480 


class Boids: 
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def 


def 


def 


def 


def 


def 


class that represents Boids simulation""" 
. init (self, N): 

"""initialize the Boid simulation""" 

# initial position and velocities 


self.pos = [width/2.0, height/2.0] + 10*np.random.rand(2*N).reshape(N, 2) 


# normalized random velocities 

angles - 2*math.pi*np.random.rand(N) 

self.vel = np.array(list(zip(np.sin(angles), np.cos(angles)))) 
self.N = N 

# minimum distance of approach 

self.minDist = 25.0 

# maximum magnitude of velocities calculated by "rules" 
self.maxRuleVel = 0.03 

# maximum maginitude of the final velocity 

self.maxVel = 2.0 


tick(self, frameNum, pts, beak): 

"""Update the simulation by one time step.""" 

# get pairwise distances 

self.distMatrix = squareform(pdist(self.pos) ) 

# apply rules: 

self.vel += self.applyRules() 

self.limit(self.vel, self.maxVel) 

self.pos += self.vel 

self .applyBC() 

# update data 

pts.set_data(self.pos.reshape(2*self.N)[::2], 
self.pos.reshape(2*self.N)[1::2]) 

vec = self.pos + 10*self.vel/self.maxVel 

beak.set data(vec.reshape(2*self.N)[::2], 
vec.reshape(2*self.N)[1::2]) 


limitVec(self, vec, maxVal): 
"""limit the magnitide of the 2D vector""" 
mag - norm(vec) 
if mag » maxVal: 
vec[0], vec[1] = vec[0]*maxVal/mag, vec[1]*maxVal/mag 


limit(self, X, maxVal): 
"""limit the magnitide of 2D vectors in array X to maxValue""" 
for vec in X: 

self.limitVec(vec, maxVal) 


applyBC(self): 
"""apply boundary conditions""" 
deltaR - 2.0 
for coord in self.pos: 
if coord[0] > width + deltaR: 
coord[0] = - deltaR 
if coord[0] < - deltaR: 
coord[0] = width + deltaR 
if coord[1] > height + deltaR: 
coord[1] = - deltaR 
if coord[1] < - deltaR: 
coord[1] = height + deltaR 


applyRules(self): 
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# apply rule #1: Separation 

D = self.distMatrix < 25.0 

vel = self.pos*D.sum(axis=1).reshape(self.N, 1) - D.dot(self.pos) 
self.limit(vel, self.maxRuleVel) 


# distance threshold for alignment (different from separation) 
D = self.distMatrix < 50.0 


# apply rule #2: Alignment 

vel2 = D.dot(self.vel) 
self.limit(vel2, self.maxRuleVel) 
vel += vel2; 


# apply rule #3: Cohesion 

vel3 = D.dot(self.pos) - self.pos 
self.limit(vel3, self.maxRuleVel) 
vel += vel3 


return vel 


def buttonPress(self, event): 
"""event handler for matplotlib button presses""" 
# left-click to add a boid 
if event.button is 1: 
self.pos = np.concatenate((self.pos, 
np.array([[event.xdata, event.ydata]])), 
axis=0) 
# generate a random velocity 
angles = 2*math.pi*np.random.rand(1) 
v = np.array(list(zip(np.sin(angles), np.cos(angles)))) 
self.vel - np.concatenate((self.vel, v), axis-0) 
Self.N *- 1 
# right-click to scatter boids 
elif event.button is 3: 
# add scattering velocity 
self.vel += 0.1*(self.pos - np.array([[event.xdata, event.ydata]])) 


def tick(frameNum, pts, beak, boids): 
#print frameNum 
"""update function for animation""" 
boids.tick(frameNum, pts, beak) 
return pts, beak 


# main() function 


def main(): 
# use sys.argv if needed 
print('starting boids...') 


parser = argparse.ArgumentParser(description-"Implementing Craig 
Reynold's Boids...") 

# add arguments 

parser.add_argument('--num-boids', dest='N', required=False) 

args = parser.parse_args() 


# set the initial number of boids 


N = 100 
if args.N: 
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N = int(args.N) 


# create boids 
boids = Boids(N) 


# set up plot 
fig = plt.figure() 
ax = plt.axes(xlim=(0, width), ylim=(0, height) ) 


pts, = ax.plot([], [], markersize=10, c='k', marker='0', ls-'None') 

beak, = ax.plot([], [], markersize-4, c-'r', marker='0', ls-'None') 

anim = animation.FuncAnimation(fig, tick, fargs=(pts, beak, boids), 
interval=50) 


# add a "button press" event handler 
cid = fig.canvas.mpl connect('button press event', boids.buttonPress) 


plt.show() 
# call main 


if name == main 
main() 





运行 类 乌 群 模拟 
让 我 们 来 看 看 ， 运 行 模拟 时 会 发 生 什么 。 输 入 以 下 内 容 : 
$ python3 boids.py 
AR ART AS. 所 有 个 体 应 该 聚集 在 窗口 的 中 心 附近 。 让 模拟 运行 一 段 时 间 ， 
类 鸟 群 应 该 开 群 聚 ， 构 成 的 模式 类 似 于 图 5-4 所 示 。 
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示例 


> 


5-4 类 乌 群 的 运 
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点 击 模拟 窗口 。 新 的 个 体 应 该 出 现在 该 位 置 ， 当 它 遇 到 乌 群 时 ， 速 度 应 改变 。 
现在 ， 单 击 鼠 标 右键 。 乌 群 应 首先 分 散 ， 但 随后 重新 聚集 。 



































56 小 结 





这 个 项 目 利用 Craig Reynolds 提出 的 3 个 规则 ， 模 拟 鸟 群 〈 或 类 鸟 群 ) 的 聚集 。 
我 们 学 习 了 如 何 使 用 numpy 数组 ,如 何 使 用 显 式 循环 ， 以 及 用 整个 数组 上 的 numpy 
方法 来 提高 计算 速度 。 我 们 利用 scipy.spatial 模块 来 执行 快速 和 方便 的 距离 计算 , 实 
现 了 一 个 matplotlib 技巧 ， 利 用 两 个 记号 来 表示 个 体 的 位 置 和 方向 。 最 后 ， 增 加 了 
UI 交 互 ， 可 以 按 下 鼠标 按钮 来 改变 matplotlib 的 绘图 。 























































































































5.7 实验 

















下 面 有 一 些 方式 ， 可 以 进一步 探索 群 聚 行为 。 
1. 为 类 鸟 群 实现 避 障 ， 编 写 一 个 新 方法 avoidObstacle0， 并 在 应 用 3 个 规则 之 
后 应 用 它 ， 像 下 面 这 样 : 


self.vel += self.applyRules() 
self.vel += self.avoidObstacle() 































































































avoidObstacle() 方 法 应 该 使 用 预先 定义 的 元 组 (x, y, R)， 为 个 体 增加 一 个 速度 分 
量 ， 将 它 推 离 障碍 物 的 位 置 (x，y)， 但 只 在 个 体 处 于 障碍 物 的 半径 R 之 内 时 。 可 以 
将 其 视 为 是 个 体 看 见 障碍 物 , 并 避 开 它 的 距离 。 可 以 用 命令 行 选项 指定 (x, y, R) 元 组 。 

2. 如 果 类 乌 群 飞 过 一 阵 强 风 ， 会 发 生 什么 情况 ? 以 随机 选择 的 时 间 步 又 ， 对 
所 有 个 体 增加 一 个 全 局 的 速度 分 量 ， 来 模拟 这 种 情况 。 类 乌 群 应 该 暂时 受到 风 的 影 
啊 ， 但 风 停止 后 又 回 到 群 聚 状 态 。 












































































































































76 Python 极 客 项 目 编程 


第 三 部 分 


BA ZA 




















“你 可 以 通过 视觉 观察 到 很 多 东西 。” 
— — Yogi Berra 











*Os 


ASCII 文本 图 形 





在 20 世纪 90 ER, 电子 邮件 占据 着 统治 地 位 , 图 形 处 理 能 
力 很 有 限 , 常见 的 做 法 是 在 电子 邮件 中 包含 一 个 签名 , 它 是 由 文 
本 制作 的 图 形 , 一 般 称 为 ASCII 文本 图 形 (ASCI 是 一 个 简单 的 
字符 编码 方案 )。 图 6-1 展示 了 两 个 例子 。 尽 管 因特网 已 经 让 共 
图 像 容 易 很 多 ， 但 出 身 摆 微 的 文本 图 形 还 没有 消失 。 

ASCII 文本 图 形 的 源头 是 19 世纪 后 期 出 现 的 打字 机 文本 图 
形 。 在 20 世纪 60 ER, 计算 机 有 了 较 弱 的 图 形 处 理 硬件 ，ASCII 被 用 于 表示 图 形 。 
今天 ，ASCII 文本 图 形 继续 作为 因特网 上 的 一 种 表现 形式 ， 你 可 以 在 网 上 找到 各 种 
创意 的 例子 。 

这 个 项 目 用 Python 创建 一 个 程序 ， 从 图 像 生 成 ASCI 文本 图 形 。 该 程序 让 你 
指定 输出 (文本 列 数 ) 的 宽度 , 并 设置 垂直 比例 因子 。 它 也 支持 两 种 灰 度 值 到 ASCII 
字符 的 映射 : PREY 10 级 映射 和 更 精细 校正 的 70 级 映射 。 

要 从 图 像 生 成 ASCI 文本 图 形 ， 需 要 学 习 如 何 做 到 以 下 几 点 : 

。 用 Pillow 将 彩色 图 像 转换 成 灰 度 图 像 ， 它 是 Python WARE PL) 的 一 个 
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。 使 用 numpy 计算 灰 度 图 像 的 平均 亮度 ; 
。 用 一 个 字符 串 作 为 灰 度 值 的 快速 查找 表 。 


























y —————————————— 


x + 
>(814) 865-9931 + 
ax ==> (814) 863-6734 + 





1————— — 


veb page --» http://wwv,personal.psu,.edu/-rxj10 





图 6-1 ASCH 文本 图 形 的 例子 


61 工作 原理 

该 项 目 利 用 了 这 样 一 个 事实 : 从 远 处 看 ， 我 们 将 灰 度 图 像 看 成 是 它们 亮度 的 
平均 值 。 例 如 ， 在 图 6-2 中 ， 可 以 看 到 一 个 建筑 物 的 灰 度 图 像 ， 在 它 旁 边 ， 是 填 
充 了 该 建筑 物 图 像 的 平均 亮度 值 的 图 像 。 如 果 穿 过 一 间 屋 子 来 看 这 两 幅 图 像 ， 它 
们 看 起 来 相似 。 

ASCII 文本 图 形 的 生成 方法 是 ， 将 图 像 分 割 成 小 块 ， 并 用 ASCII 字符 替换 一 小 
块 的 平均 RGB 值 。 从 远 处 看 ， 因 为 眼睛 的 分 辨 率 有 限 ， 我 们 大 致 会 丢失 细节 ， 看 
到 ASCI 文本 图 形 中 的 “平均 ” 值 ， 否 则 文本 图 形 看 起 来 就 不 那么 真实 。 











6-2 灰 度 图 像 的 平均 值 
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该 程序 将 给 定 的 图 
[0,255] (8 位 整数 的 范围 

















像 先 转换 为 8 位 的 灰 度 ， 让 每 个 像素 有 一 个 灰 度 值 ， 范 
































中 间 值 是 不 同 程度 的 灰色 。 


接着 ， 将 该 
本 图 形 中 的 行 和 
义 的 一 些 有 梯度 
与 适当 的 ASCII 





























PS Ate 


字符 
完成 的 ASCII 文本 图 










































































些 文 本 行 。 


E 
EHE 





的 等 宽 字 体 ， 因 








m 


f 








所 
所 占 空 


x 
W] 
O 






































为 了 解决 这 个 问题 ， 需 要 缩放 网 格 ， 
向 程序 发 送 命令 行 参数 ， 修 改 缩放 ， 以 匹配 

总 之 ， 下 面 是 程序 生成 ASCII 文本 图 
图 像 转 成 灰 度 ; 
像 分 成 MXN 个 小 块 ; 
. 修正 M( 行 数 )， 以 匹配 图 
. 计算 每 个 小 块 
汇集 各 行 ASCII 字符 





.将 输入 
将 图 








Un A WN 一 





6.2 ”所 需 模块 


岗 失真 。 实 际 上 ， 你 试 
匹配 。 例 如 ， 如 果 将 图 
































133] 


Couri 











啊 最 终 图 像 。 如 果 一 
































图 














像 小 块 ， 所 以 它 



































的 行 























NS 








pm 





像 和 字体 的 横 纵 比 ; 











图 像 的 平均 亮度 ， 然 后 为 每 个 小 块 查找 合适 的 ASCH 
串 ， 将 它们 打印 到 文件 ， 形 成 最 终 


图 像 。 

















这 个 项 目 将 使 





底层 数据 ， 创 建 并 


63 ”代码 








成 最 终 的 输出 。 


Ae AR 
9 = 二。 





开始 先 定义 灰 度 等 级 ， 用 于 生成 ASCII 文本 图 
mA, üt 
最 后 ， 为 程序 设置 命令 行 解 析 ， 人 允许 











] Pillow (Python 图 








像 库 的 友好 分 支 ) 来 读 取 图 





像 ， 访 问 


BAe. EA numpy 库 来 计算 平均 值 。 


























7. 
Z o 


























这 些小 块 的 平均 亮度 。 接 下 来 ， 





























整个 项 目的 代码 ， 请 参阅 6.4 节 。 


j 户 指定 输出 尺寸 、 输 


然后 ， 考 虑 如 何 将 图 
FA ASCII 字符 蔡 换 小 














第 6 章 ASCIll 文本 图 形 


高 度 拉 伸 的 字体 替换 


围 在 





)。 将 这 个 8 位 值 看 成 是 亮度 ，0 表示 黑色 ，255 表示 白色 ， 


图 像 分 割 成 MXN 个 小 块 构成 的 网 格 (其 中 ，M 和 NN 是 ASCII X 
列 编号 )。 然 后 程序 计算 网 格 中 每 个 小 块 的 平均 亮度 值 ， 通 过 预定 
的 ASCH 字符 〈 一 组 不 断 增加 的 值 ) 来 表示 [0,255] 范 
匹配 。 它 将 用 这 些 值 作为 亮度 值 的 查找 表 。 

要 显示 文本 ， 就 要 
为 如 果 每 个 文本 字符 宽度 不 相同 ， 图 像 中 字符 将 无 法 了 
排列 ， 会 得 到 间隔 不 均 和 失真 的 输出 。 
字体 的 “ 横 纵 比 ”( 宽 度 与 高 度 之 比 〉 也 会 影 
闻 的 横 纵 比 与 该 字符 取代 的 图 像 小 块 的 横 纵 比 不 同 , 则 最 终 的 ASCII 字符 图 
一 个 ASCH 字符 来 替换 图 
像 分 割 成 正方 形 小 块 ， 然 后 用 一 和 


围 的 灰 度 值 ， 





er 这 样 


E 确 地 按 网 格 


AN By bets 


PY 











们 的 





NS 





数 ， 以 匹配 Courier 的 长 宽 比 。( 可 以 
他 字体 。) 


PS Ar 


FAT 


它们 的 





BAN 
块 ， 生 
出 文件 


81 


6.3.1 定义 灰 度 等 级 和 网 格 


6.3.2 





























创建 程序 的 第 一 步 是 ， 先 定义 两 种 灰 度 等 级 作为 全 局 值 ， 用 于 将 亮度 值 转换 为 











ASCII 字符 。 


# 70 levels of gray 
© gscale1 = "$@B%8&WM#* oahkbdpqwmZOOQLCJUYXzcvunxrjft/\|()1{}[]?-_t+~<>illIj;:,\"* ^" 


# 10 levels of gray 
@ gscale2 = "@%#*+=-:,. " 





@ 行 的 值 gscalel 是 70 级 的 灰 度 梯度 , @ 行 的 gscale2 是 简单 的 10 级 灰 度 梯度 。 


























这 两 个 值 保 存 为 字符 串 ， 包 含 一 组 字符 串 ， 从 最 黑暗 变 到 最 亮 〈《 要 了 解 如 何 用 字符 





























表示 灰 度 值 的 更 多 内 容 , 参见 Paul Bourke 的 《Character Representation of Grey Scale 


Images》， 网 址 在 http://paulbourke.net/dataformats/asciiart/ ) o 











既然 有 了 灰 度 梯度 ， 就 可 以 准备 图 像 。 下 面 的 代码 打开 图 像 ， 并 分 割 成 网 格 : 


# open the image and convert to grayscale 

image = Image.open(fileName).convert("L") 

# store the image dimensions 

W, H = image.size[0], image.size[1] 

# compute the tile width 

w = W/cols 

# compute the tile height based on the aspect ratio and scale of the font 
h = w/scale 

# compute the number of rows to use in the final grid 

rows = int(H/h) 




















在 @ 行 ，Image.open0 打 开 输 入 图 像 文件 ，Image.convert0 将 该 图 像 转换 为 灰 度 





图 像 。“L” 代 表 luminance， 是 图 像 亮 度 的 单位 。 























在 @ 行 ， 保 存 输 入 图 像 的 宽度 和 高 度 。 在 @ 行 ， 根 据 用 户 指定 的 列 数 (cols)， 






































计算 小 块 的 宽度 如果 用 户 没有 在 命令 行 中 设置 其 他 值 ， 程 序 默 认 使 用 80 列 )。 对 




















于 @@ 行 的 除法 ， 使 用 浮 点 而 不 是 整数 除法 ， 避 免 在 计算 小 块 尺寸 时 的 截断 误差 。 


度 






































知道 小 块 的 宽度 后 ， 在 @ 行 利用 垂直 比例 系数 (作为 scale 传 入 )， 计 算 它 的 高 
































































































































。 在 @ 行 ， 用 这 个 网 格 高 度 来 计算 行 数 。 
比例 系数 确定 每 个 小 块 的 大 小 ， 以 匹配 用 于 显示 文本 的 字体 的 横 纵 比 ， 这 样 最 
图 像 不 会 失真 sscale 的 值 可 以 作为 参数 传 入 ,或 者 设置 为 默认 值 0.43, 444 Courier 











显示 结果 时 ， 效 果 很 好 。 





计算 平均 亮度 





接 下 来 ， 计 算 灰 度 图 像 中 每 一 小 块 的 平均 亮度 。 函 数 getAverageLO 完 成 这 项 


TES 
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© def getAverageL (image): 
# get the image as a numpy array 


e im - np.array(image) 
# get the dimensions 
e w,h - im.shape 
# get the average 
o return np.average(im.reshape(w*h)) 





在 @ 行 ,图 像 小 块 作为 PIL Image 对 象 传 入 .在 @ 行 将 image 转换 成 一 个 numpy 
数组 ， 此 时 im 成 为 一 个 二 维 数 组 ， 包 含 每 个 像素 的 亮度 。 在 目 行 ， 保 存 该 图 像 的 
尺寸 (宽度 和 高 度 )。 在 @ 行 ，numpy.average() 计 算 该 图 像 中 的 亮度 平均 值 ， 做 法 是 
用 numpy.reshape() 先 将 维度 为 宽 和 高 (w，h) 的 二 维 数组 转换 成 扁平 的 一 维 ， 其 长 度 
是 宽度 乘 以 高 度 (w*h)。 然 后 aumpyaverage0 调 用 对 这 些 数组 值 求 和 并 计算 平均 值 。 














































































































6.3.3 ”从 图 像 生 成 ASCII 内 容 
程序 的 主要 部 分 负责 从 图 像 生成 ASCII 内 容 。 


# an ASCII image is a list of character strings 
o aimg = [] 
# generate the list of tile dimensions 
for j in range(rows): 
e yl = int(j*h) 
y2 = int((j+1)*h) 
# correct the last tile 
if j == rows-1: 
y2 =H 
# append an empty string 
e aimg.append("") 
for i in range(cols): 
# crop the image to fit the tile 
o x1 = int(i*w) 
x2 = int((i*1)*w) 
# correct the last tile 

















e if i -- cols-1: 
X2 = W 
# Crop the image to extract the tile into another Image object 
e img = image.crop((x1, y1, x2, y2)) 
# get the average luminance 
o avg = int(getAverageL(img)) 


# look up the ASCII character for grayscale value (avg) 
if moreLevels: 


e gsval = gscale1[int((avg*69) /255) ] 
else: 
e gsval = gscale2[int((avg*9)/255)] 
# append the ASCII character to the string 
四 aimg[j] += gsval 

















在 程序 的 这 一 部 分 ，ASCII 图 像 先 作为 一 个 字符 串 列表 保存 ， 该 列表 在 @ 行 初 
始 化 。 接 下 来 ， 按 计算 好 的 图 像 小 块 行 数 迭代 人 遍历， 在 @ 行 和 随后 一 行 中 ， 计 算 每 
个 图 像 小 块 的 起 始 和 结束 y 坐标 。 虽 然 这 些 是 浮 点 运算 ， 但 在 传 给 图 像 裁剪 方法 之 
前 ， 将 它们 截断 为 整数 。 
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接着 ， 因 为 只 有 当 图 像 的 宽度 是 列 数 的 整数 倍 时 ， 图 像 分 割 成 小 块 时 ， 边 缘 的 

小 块 才 有 相同 的 大 小 ， 所 以 在 最 后 一 行 校正 小 块 的 y 坐标 ， 将 y 坐标 设置 为 图 像 的 
实际 高 度 。 这 样 做 确保 了 图 像 顶部 的 边缘 不 被 截断 。 
fEO T. N ASCH 图 像 添加 一 个 空 字 符 串 ， 作 为 一 种 紧凑 的 方式 来 表示 图 像 的 
当前 行 。 接 下 来 会 填充 这 个 字符 串 (将 字符 串 作为 字符 的 列表 )。 
在 @ 行 和 下 一 行 ， 计 算 每 个 小 块 的 左 、 右 x 坐标 ， 在 @ 行 ， 为 最 后 一 小 块 校 
TE x 坐标 ， 原 因 和 校正 y 坐标 时 一 样 。 在 @ 行 ， 用 image.crop0) 提 取 图 像 小 块 ， 
然后 将 该 小 块 传 入 getAverageLO 函 数 @， 该 函数 在 6.3.2 节 中 定义 ， 取 得 小 块 的 
平均 亮度 。 在 @ 行 ， 将 平均 亮度 值 从 [0，255] 缩 小 至 [0，9] (默认 10 级 灰 度 梯度 
值 的 范围 )。 然 后 ， 用 gscale2《〈 保 存 的 梯度 字符 串 ) 作为 查找 表 ， 找 到 对 应 的 
ASCI 值 。@ 行 类 似 ， 不 同 之 处 在 于 ， 只 有 命令 行 标志 设置 为 使 用 TO 级 梯度 时 ， 
才 会 用 它 。 最 后 ， 在 四 行 ， 在 文本 行 中 添加 找到 的 ASCII 值 gsval， 代 码 循环 ， 
直到 处 理 完 所 有 行 。 





























































































































































































































Ings 
6.3.4 ”命令 行 选项 
x ` 2 N ELS MN Y D 
接 下 来 ， 为 程序 定义 一 些 命令 行 选项 。 这 段 代码 使 用 内 置 的 argparse 25: 
parser = argparse.ArgumentParser (description="descStr" ) 
# add expected arguments 
parser.add argument('--file', dest-'imgFile', required=True) 
parser.add argument('--scale', dest-'scale', required-False) 
parser.add argument('--out', dest-'outFile', required-False) 
parser.add argument('--cols', dest-'cols', required-False) 
parser.add argument('--morelevels', dest-'moreLevels', action-'store true') 


在 @ 行 , 包含 指定 图 像 文 件 输 入 的 选项 (唯一 必须 的 参数 )，@ 行 设置 王 直 比例 
因子 ，@ 行 设置 输出 文件 名 ，@ 行 设置 ASCU 输出 中 的 文本 列 数 。 在 @ 行 ， 添 加 
--morelevels 选项 ， 让 用 户 选 择 更 多 层次 的 灰 度 梯度 。 











00000 
























































6.3.5 将 ASCII 文本 图 形 字 符 串 写 入 文本 文件 
最 后 ， 将 生成 的 ASCI 字符 串 列表 ， 写 入 一 个 文本 文件 : 


# open a new text file 


o f = open(outFile, 'w') 
# write each string in the list to the new file 
e for row in aimg: 
f.write(row + '\n') 
# clean up 
e f.close() 























在 @ 行 ， 使 用 内 置 的 open0 方 法 ， 打 开 一 个 新 的 文本 文件 用 于 写 入 。 然 后 在 @ 
行 ， 迭 代 壳 历 列表 中 的 每 个 字符 串 ， 将 它 写 入 文件 ， 在 目 行 ， 关 闭 文件 对 象 ， 释 放 
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6.4 ”完整 代码 


下 面 是 完整 的 ASCH 文本 图 形 程序 。 也 可 以 从 https://github.com/electronut/pp/ 
blob/master/ascii/ascii.py 下 载 该 项 目的 代码 。 


import sys, random, argparse 
import numpy as np 

import math 

from PIL import Image 




















# grayscale level values from: 
# http://paulbourke.net/dataformats/asciiart/ 


# 70 levels of gray 

gscale1 = "$@B%88&WM#*oahkbdpqwmZOOQLCJUYXzcvunxrjft/\|()1{}[]?-_+~<>i!llI;:,\"” 
# 10 levels of gray 

gscale2 = '@%x#*+=-:, ' 


def getAverageL(image): 


Given PIL Image, return average value of grayscale value 
# get image as numpy array 

im = np.array (image) 

# get the dimensions 

w,h = im.shape 

# get the average 

return np.average(im.reshape(w*h) ) 


def covertImageToAscii(fileName, cols, scale, moreLevels): 


Given Image and dimensions (rows, cols), returns an m*n list of Images 
# declare globals 

global gscale1, gscale2 

# open image and convert to grayscale 

image = Image.open(fileName).convert('L') 

# store the image dimensions 

W, H = image.size[0], image.size[1] 

print("input image dims: %d x %d" % (W, H)) 

# compute tile width 

w = W/cols 

# compute tile height based on the aspect ratio and scale of the font 
h = w/scale 

# compute number of rows to use in the final grid 

rows = int(H/h) 


% 


print("cols: %d, rows: %d (cols, rows)) 
print("tile dims: %d x %d" % (w, h)) 


# check if image size is too small 

if cols > W or rows > H: 
print("Image too small for specified cols!") 
exit (0) 
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# an ASCII image is a list of character strings 
aimg = [] 
# generate the list of tile dimensions 
for j in range(rows): 
yl = int(j*h) 
y2 = int((j+1)*h) 
# correct the last tile 
if j == rows-1: 
y2 =H 
# append an empty string 
aimg.append("") 
for i in range(cols): 
# crop the image to fit the tile 
x1 = int(i*w) 
x2 = int((i+1)*w) 
# correct the last tile 
if i == cols-1: 
x2 =W 
# crop the image to extract the tile into another Image object 
img = image.crop((x1, y1, x2, y2)) 
# get the average luminance 
avg = int(getAverageL (img) ) 
# look up the ASCII character for grayscale value (avg) 
if moreLevels: 
gsval = gscale1[int((avg*69) /255) ] 
else: 
gsval = gscale2[int((avg*9)/255)] 
# append the ASCII character to the string 
aimg[j] += gsval 


# return text image 
return aimg 


# main() function 


def main(): 
# create parser 
descStr = "This program converts an image into ASCII art." 


parser = argparse.ArgumentParser (description=descStr) 

# add expected arguments 

parser.add argument('--file', dest-'imgFile', required=True) 
parser.add argument('--scale', dest-'scale', required-False) 


parser.add argument('--out', dest-'outFile', required-False) 
parser.add argument('--cols', dest-'cols', required-False) 
parser.add argument('--morelevels', dest-'moreLevels', action-'store true') 


# parse arguments 
args - parser.parse args() 


imgFile - args.imgFile 
# set output file 
outFile - 'out.txt' 
if args.outFile: 
outFile = args.outFile 
# set scale default as 0.43, which suits a Courier font 
scale = 0.43 
if args.scale: 
scale = float(args.scale) 
# set cols 
cols = 80 
if args.cols: 
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cols = int(args.cols) 


print ( 


‘generating ASCII art...') 


# convert image to ASCII text 


aimg = 


# open 


covertImageToAscii(imgFile, cols, scale, args.moreLevels) 


a new text file 


f = open(outFile, 'w') 
# write each string in the list to the new file 
for row in aimg: 
f.write(row + '\n') 
# clean up 
f.close() 


print ( 


"ASCII art written to %s" % outFile) 


# call main 


if name 


== ' gain 





main() 


6.5 ”运行 ASCII 文本 图 形 生成 程序 


要 运行 编写 好 的 程序 ， 输 入 类 似 下 面 这 样 的 命令 ， 将 data/robot.jpg 蔡 换 为 你 想 
使 用 的 图 像 文件 的 相对 路 径 。 


$ python ascii.py --file data/robot.jpg --cols 100 











图 6-3 展示 了 ASCU 文本 图 形 ， 它 是 左 侧 的 robot.jpg 的 结果 。 











现在 


6.6 小 结 


6-3 ascii.py 的 运行 示例 


， 你 可 以 创建 自己 的 ASCI 文本 图 形 了 ! 


在 这 个 项 目 中 ,我 们 学 习 了 如 何 从 任意 的 输入 图 像 生 成 ASCII 文本 图 形 。 我 们 


还 学 习 了 如 何 计算 平均 亮度 值 ， 将 图 像 转 换 成 灰 度 ， 以 及 如 何 基于 灰 度 值 用 字符 替 


换 一 小 块 









































图 像 。 创 建 自己 的 ASCI 文本 图 形 ， 祝 你 玩 得 开心 ! 
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67 实验 
































这 里 有 一 些 想法 ， 可 以 进一步 探索 ASCH 文本 图 形 。 

1. 用 命令 行 选项 --scale1.0 运行 该 程序 。 生 成 的 图 像 看 起 来 如 何 ? 实验 不 同 的 
scale 值 。 将 输出 复制 到 一 个 文本 编辑 器 ， 尝 试 设置 不 同 的 (固定 宽度 ) 字体 ， 看 看 
这 样 做 如 何 影响 最 终 图 形 的 外 观 。 

2. 为 程序 添加 命令 行 选项 --invert， 反 转 ASCII 文本 图 形 的 输入 值 ， 使 黑色 变 
成 和 白色， 反之 亦 然 〈 提 示 : 在 查找 时 用 255 减 去 小 块 的 亮度 值 )。 

3. 在 这 个 项 目 中 ， 基 于 两 个 字符 硬 编码 的 梯度 创建 灰 度 值 查 找 表 。 实 现 一 个 
命令 行 选项 ， 用 不 同 的 字符 梯度 来 创建 ASCI 文本 图 形 ， 就 像 这 样 : 
python3 ascii.py --map "@$%**." 

前 面 这 样 的 梯度 用 给 定 的 6 个 字符 梯度 ， 创 建 了 一 个 ASCI 输出 ， 其 中 “@” 
映射 到 亮度 值 0,“.” 映 射 到 亮度 值 255。 
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als 


照片 马赛 克 








我 在 六 年 级 时 ， 看 到 一 张 类 似 图 7-1 的 图 像 , 但 不 太 明 白 它 
是 什么 。 睐 着 眼睛 看 了 一 阵 后 ， 我 终于 想 通 了 《把 书 倒 过 来 ， 离 
远 一 点 看 它 。 

照片 马赛 克 是 一 张 图 像 , 它 被 分 割 成 长 方形 的 网 格 , 每 个 长 
方形 由 另 一 张 区 配 “目标” 的 图 像 (最 终 希 望 出 现在 照片 马赛 砚 
中 的 图 像 ) EH. RAZ, WR awe Se, 会 看 到 目 
标 图 像 ， 但 如 果 走 近 ， 会 看 到 该 图 像 实际 上 包含 许多 较 小 的 图 像 。 

这 个 迷 题 有 解 是 因为 人 眼 的 工作 方式 。 图 7-1 中 的 低 分 辨 率 块 状 图 像 ， 靠 近 
恨 难 识别 ， 但 如 果 从 远 处 看 ， 就 知道 它 代 表 什 么 ， 因 为 看 到 的 细节 较 少 ， 就 使 得 
缘 越 光滑 。 照 片 马赛 克 的 原理 是 相似 的 。 从 远 处 看 ， 图 像 看 起 来 正常 ， 但 走 近 时 ， 
秘密 揭 开 了 : “ 块 ”都 是 一 个 独特 的 图 像 ! 

本 项 目 中 ， 我 们 将 学 习 如 何 用 Python 创建 照片 马赛 克 。 我 们 将 目标 图 像 划 
分 成 较 小 图 像 的 网 格 ， 并 用 适当 的 图 像 蔡 换 网 格 中 的 每 一 小 块 ， 创 建 原始 图 像 的 
照片 马赛 元 。 你 可 以 指定 网 格 的 尺寸 并 选择 输入 图 像 是 否 可 以 在 马赛 元 中 重复 
使 用 。 
在 这 个 项 目 中 ， 你 将 学 习 如 何 做 到 以 下 几 点 : 
e 用 Python AR (PIL) 创建 图 像 ; 
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计算 图 像 的 平均 RGB 值 ; 

88] ER s 

通过 粘贴 男 一 张 图 像 来 蔡 代 原 图 像 的 一 部 分 ; 
利用 平均 距离 测量 来 比较 RGB 值 。 











图 7-1 SAR ARH AR 


71 工作 原理 
要 创建 照片 马赛 克 ， 就 从 目标 图 像 的 块 状 低 分 辩 率 版 本 开始 《 


因为 在 高 分 辨 率 








的 图 像 中 ， 小 块 图 像 的 数量 会 太 大 )。 该 图 像 的 分 辨 率 将 决定 马赛 元 的 维度 MXN 
(M 是 行 数 ，N 是 列 数 )。 接 着 ,根据 这 种 方法 蔡 换 原始 图 像 中 的 每 一 小 块 : 





1. 读 入 一 些小 块 图 像 ， 它 们 将 取代 原始 图 像 中 的 小 块 ; 
读 入 目标 图 像 ， 将 它 分 割 成 MXN 的 小 块 网 格 ; 
对 于 每 个 小 块 ， 从 输入 的 小 块 图像 中 找到 最 佳 匹配 ; 








Bow 


7.1.1 分 割 目标 图 像 
按照 图 7-2 中 的 方案 ， 开 始 将 目标 图 像 划 分 成 MXN 的 网 格 。 
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.将 选择 的 输入 图 像 安排 在 MXN 的 网 格 中 ， 创 建 最 终 的 照片 马赛 克 。 


i (0 到 w*n 行 ) 


(i*w, i*j) 


m 
c 
E 
EJ h 
A — (iyw, (+1)*h) 
w 





7-2 ”分割 目标 图 像 


图 7-2 中 的 图 像 展示 了 如 何 将 原始 图 像 分 割 成 小 块 的 网 格 。x 轴 表 示 网 格 的 列 ， 
y 轴 表 示 网 格 的 行 。 

现在 ， 看 看 如 何 计算 网 格 中 一 个 小 块 的 坐标 。 下 标 为 〈i，j) 的 小 块 ， 左 上 角 
坐标 为 (iw, 让 )， 右 下 角 坐 标 为 (i+D)*w, G+1)*h)， 其 中 w 和 分 别 是 小 块 的 宽度 
和 高 度 。PIL 可 以 用 这 些 数据 ， 从 原 图 像 创建 小 块 。 








7.1.2 ”平均 颜色 值 

图 像 中 的 每 个 像素 都 有 颜色 ， 由 它 的 红 、 绿 、 蓝 值 来 表示 。 在 这 个 例子 中 ， 使 
用 8 位 的 图 像 ， 因 此 每 个 部 分 有 8 位 值 ， 范 围 在 [0,255]。 如 果 一 幅 图 像 共 用 个 像 
A, ES RGB 计算 如 下 : 




















px ntr + +y 8+8 +t +g b +b, 4b, 
E > N + N + N 








请 注意 ， 平 均 RGB 也 是 一 个 三 元 组 ， 不 是 标量 或 一 个 数字 ， 因 为 平均 值 是 针 
对 每 个 颜色 成 分 分 别 计算 的 。 计 算 平 均 RGB 是 为 了 匹配 图 像 小 块 和 目标 图 像 。 








7.1.3 ”匹配 图 像 
对 于 目标 图 像 中 的 每 个 小 块 ， 需 要 在 用 户 指定 的 输入 文件 夹 的 一 些 图 像 中 ， 找 
到 一 幅 匹 配 的 图 像 。 要 确定 两 个 图 像 是 否 匹 配 ， 就 使 用 平均 RGB 值 。 最 接近 的 匹 
配 就 是 最 接近 平均 RGB 值 的 图 像 。 
要 做 到 这 一 点 ， 最 简单 的 方法 是 计算 一 个 像素 中 RGB 值 之 间 的 距离 ， 以 便 从 
输入 图 像 中 找到 最 佳 匹配 。 对 于 几何 中 的 三 维 点 ， 可 以 用 以 下 的 距离 计算 方法 : 
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D,, = Jf -nY +(8,- g,Y +b, by 
这 里 计算 了 点 (m, g, bD 和 Gro, go, bo) 之 间 的 距离 。 给 定 一 个 目标 图 像 的 平均 
RGB 值 ， 以 及 来 自 输入 图 像 的 平均 RGB 值 列 表 ， 你 可 以 使 用 线性 搜索 和 三 维 点 的 
距离 计算 ， 来 找到 最 匹配 的 图 像 。 





































































































7.0 ”所 需 模块 


这 个 项 目 将 使 用 Pillow 读 入 图 像 ， 访 问 其 底层 数据 ， 创 建 和 修改 图 像 。 还 会 用 
numpy 来 操作 图 像 数 据 。 


















































7.3 代码 
































首先 读 入 那些 小 块 图 像 ， 它 们 将 用 于 创建 照片 马赛 元 。 接 下 来 ， 计 算 图 像 的 平 
均 RGB 值 ， 然 后 将 目标 图 像 分 割 成 图 像 网 格 ， 为 小 块 找到 最 佳 匹配 。 最 后 ， 组 装 
图 像 小 块 ， 创 建 最 终 的 照片 马赛 元 。 要 查看 完整 的 项 目 代码 ， 请 直接 跳 到 7.4 节 。 


















































7.3.1 读 入 小 块 图 像 
首先 ， 从 给 定 的 文件 夹 中 读 入 输入 图 像 。 下 面 是 具体 做 法 : 


def getImages(imageDir): 



































given a directory of images, return a list of Images 


o files - os.listdir(imageDir) 
images - [] 
for file in files: 


e filePath - os.path.abspath(os.path.join(imageDir, file)) 
try: 
# explicit load so we don't run into resource crunch 
e fp = open(filePath, "rb") 


im - Image.open(fp) 
images.append(im) 
# force loading the image data from file 


o im.load() 
# close the file 
e fp.close() 
except: 
# skip 


print("Invalid image: %s" % (filePath,)) 
return images 


(E017. H os.listdir) Tt imageDir Hae BSc EUN — P ld. FR, TEAC 
遍历 列表 中 的 每 个 文件 ， 将 它 载 入 一 个 PIL Image 对 象 。 



































pa 
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在 @ 行 ， 用 os.path.abspath() fll os.path.join0 来 获取 图 像 
惯用 法 在 Python 中 经 常 使 用 ， 以 确保 代码 既 能 在 相对 路 径 下 工作 〈 如 Noovbar)， 也 























能 在 绝对 路 径 下 工作 (c:\foo\bar\)， 并 日 


目录 命名 惯例 (Windows 


















































J\I Linux 用 /)。 








要 将 文件 加 载 为 PIL 的 Image 对 象 , 可 以 将 每 个 文件 名 传 入 Image.open() 方 法 ， 














但 如 果 照 片 马 赛 殉 文件 夹 中 有 几 百 张 其 至 几 千 张 图 片 ， 这 样 
蔡 代 ,可 以 用 Python 打开 每 个 小 块 图 像 ,利用 Image.openO 将 文件 句柄 印 传 入 PILO。 
























































图 像 加 载 后 ， 关 闭 文件 名 








TEO T. 用 open0 打 开 图 像 文件 。 在 随后 的 几 行 
将 得 到 的 图 像 im 存 入 一 个 数组 。 
性 操作 ， 所 以 在 @ 行 调用 Imnage.load0， 强 制 加 载 im 中 的 








因为 open0 是 一 个 惰 














的 时 候 才 会 那么 做 。 








柄 并 释放 系统 资源 。 





能 跨 操 作 系 统 ， 不 同 的 操作 系统 有 不 同 的 


的 完整 文件 名 。 这 个 习 

















做 非常 消耗 资源 。 作 为 






































图 像 数据 。 它 确定 了 图 像 ， 但 实际 上 没有 读 取 全 部 图 像 数据 ， 




















企 @ 行 ， 关 闭 文件 句柄 ， 释 放 系 统 资源 。 


7.3.2 ”计算 输入 图 像 的 平均 颜色 值 


读 入 输入 图 像 后 ， 需 要 计算 它们 的 习 
值 。 创 建 一 个 方法 getAverageRGBO 来 计算 这 两 个 值 。 











def getAverageRGB(image): 











F 均 颜色 值 ， 以 及 目标 图 像 





， 将 文件 句柄 传 入 Image.open(), 





























直到 尝试 使 用 该 图 像 














TT 











的 每 个 小 块 的 





return the average color value as (r, g, b) for each input image 


# get each tile image as a numpy array 


o im - np.array(image) 


# get the shape of each input image 


e w,h,d = im.shape 


# get the average RGB value 
e return tuple(np.average(im.reshape(w*h, d), axis-0)) 

















(EO 1T. H numpy 将 每 个 Image 对 象 转换 为 数据 数组 。 返 














可 的 numpy 数组 形 











为 (w h, d), FEA, w 是 图 像 的 宽度 ，h 是 高 度 ，d 是 深度 ， 在 这 个 例子 中 ， 是 RGB 








图 像 的 3 个 单位 (分 别 对 应 R, G 和 B), 在 @ 行 保存 shape 元 


























E 


TPES. 








7.3.3 将 目标 图 像 分 割 成 网 格 
现在 ， 需 要 将 目标 图 
方法 来 实现 。 











E, 将 这 个 数组 变形 为 更 方便 的 形状 (wsh, qd), 这 样 就 可 以 用 























像 分 割 成 MXN 网 格 ， 包 含 更 小 的 











组 , 然后 计算 平均 RGB 


[T 


numpy.average( iT $F UH 

















图 像 。 让 我 们 创建 一 个 
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000 


def splitImage(image, size): 


given the image and dimensions (rows, cols), 


W, H = image.size[0], image.size[1] 
m, n = size 
w, h = int(W/n), int(H/m) 
# image list 
imgs = [] 
# generate a list of dimensions 
for j in range(m): 

for i in range(n): 

# append cropped image 

imgs.append(image.crop((i*w, j*h, 

return imgs 





(i+1)*w, (j+1)*h))) 


return an m*n list of images 


Ho. FEOTHEIA WARMER, HOTRAIRY. OT, HERRA 

















算 目 标 图 像 中 每 一 小 块 的 尺寸 。 














现在 ， 需 要 迭代 遍历 网 格 的 维度 ， 分 割 并 将 每 一 小 块 保存 为 单独 的 图 像 。 在 @ 








行 ，image.crop0 利 用 左上 角 图 像 坐 标 和 裁剪 图 








部 分 (在 7.1.1 小 节 中 讨论 )。 


7.3.4 寻找 小 块 的 最 佳 匹配 


ooceo 





现在 ， 让 我 们 从 输入 图 像 的 文件 夹 中 ， 找 到 小 块 的 最 人 





法 getBestMatchIndex()， 如 下 所 示 : 


def getBestMatchIndex(input_avg, avgs): 








像 的 维度 作为 参数 ， 剪 裁 出 图 像 的 一 














匹配 。 创 建 一 个 工具 方 


return index of the best image match based on average RGB value distance 


# input image average 
avg = input_avg 


# get the closest RGB value to input, based on RGB distance 


index = 0 
min_index = 0 
min_dist = float("inf") 
for val in avgs: 
dist = ((val[0] - avg[0])*(val[0] 
(val[1] - avg[1])*(val[1] 
(val[2] - avg[2])*(val[2] 
if dist < min_dist: 
min_dist = dist 
min_index = index 
index += 1 


return min_index 
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- avg[0]) + 
- avg[1]) + 
- avg[2])) 


平均 


近 的 
因 
准 公 
于 保 
平均 
RA 











需要 从 列表 avgs 中 ， 找 到 最 


RGB 值 的 列表 。 
为 了 找到 最 佳 

















匹配 ， 比 较 这 些 输入 

















Ai 














RGB 
像 的 列表 中 选择 





7.3.5 ”创建 图 像 网 格 
在 继续 创建 照片 马赛 克之 前 , 还 需要 一 个 工具 方法 。createImageGrid(0 方 法 将 创 


oo060 





建 大 
小 块 


小 为 MXN 的 图 
图 像 列表 来 创建 














匹配 的 小 块 图 








像 网 格 。 这 个 图 





o 


def createImageGrid(images, dims): 








像 网 格 是 最 终 的 照片 马赛 克 图 


图 像 的 3 








为 任何 距离 都 小 于 无 穷 大 。 在 @ 行 ， 遍 历 习 
距离 (比较 距离 的 习 
存 的 最 小 距离 min_dist， 它 就 被 蔡 换 为 新 
EJK args 中 ， 最 接近 input. avg 的 
像 了 。 


F 方 ， 以 减少 计 和 


F 均 值 列表 





匹配 平均 RGB 值 input avg 的 。avgs 是 小 块 








图 像 





F3 RGB 值 。 在 @ 行 和 @ 行 , 将 最 接 
匹配 下 标 初 始 化 为 0, 最 小 距离 初始 化 为 无 穷 大 。 该 测试 在 第 一 次 总 是 会 通过 ， 

















的 值 ， 并 开始 在 @ 行 
































的 最 小 距离 。 和 迭代 结 


时 间 )。 在 @ 行 ， 如 果 计 多 





























下 标 。 现 在 可 以 利用 这 个 下 标 ， 














given a list of images and a grid size (m, n), create a grid of images 
















































































的 距 
束 时 ， 就 得 到 了 











J 标 
离 小 








从 小 


像 ， 利 用 选择 的 


图 像 
试 过 
来 创 











m, n = dims 
# sanity check 
assert m*n == len(images) 
# get the maximum height and width of the images 
# don't assume they're all equal 
width = max([img.size[0] for img in images]) 
height = max([img.size[1] for img in images]) 
# create the target image 
grid_img = Image.new('RGB', (n*width, m*height) ) 
# paste the tile images into the image grid 
for index in range(len(images) ): 
row = int(index/n) 
col = index - n*row 
grid_img.paste(images[index], (col*width, row*height) ) 
return grid_img 
EOT, 取得 网 格 的 尺寸 , 然后 用 assert 检查 ， 提 供给 createlmageGrid() ff) 
数量 是 否 符合 网 格 的 大 小 Cassert. 方法 检查 代码 中 的 假定 ， 特 别 是 在 开发 和 测 
程 中 的 假定 )。 现 在 你 有 一 个 小 块 图 像 列 表 ， 基 于 最 接近 的 RGB 值 ， 你 将 用 它 
建 一 幅 图 像 ， 表 现 照 片 马 赛 克 。 由 于 大 小 差异 ， 某 些 选 定 的 图 像 可 能 不 会 正好 





一 个 小 块 ， 但 这 不 会 是 一 个 问题 ， 因 


























为 你 首 
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GA 


黑色 背景 填充 小 块 。 
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(Ee TI FIAT, Th) IRA eK BEE CURA EY AUN B] 
像 的 大 小 做 出 任何 假定 ， 无 论 它们 相同 或 不 同 ， 代 码 都 能 工作 )， 如 果 输 入 图 像 不 
能 完全 填充 小 块 ， 小 块 之 间 的 空间 将 显示 为 背景 色 ， 默 认 是 黑色 。 
在 @ 行 ， 创 建 一 个 空 的 Image， 大 小 符合 网 格 中 的 所 有 图 像 。 小 块 图 像 会 粘贴 
到 这 个 图 像 。 然后 填充 图 像 网 格 。 在 @ 行 ,循环 遍历 选 定 的 图 像 ， 利 用 Image.paste() 
方法 ， 将 它们 粘贴 到 相应 的 网 格 中 。Image.paste0 的 第 一 个 参数 是 要 粘贴 的 Image 
对 象 ， 第 二 个 参数 是 左上 角 的 坐标 。 现 在 ， 你 需要 搞 清楚 小 块 图 像 要 粘贴 到 图 像 网 
格 的 行 和 列 。 为 了 做 到 这 一 点 ， 将 图 像 下 标 表 示 为 行 和 列 。 小 块 在 图 像 网 格 中 的 下 
ERE N*row + col 给 出 ， 其 中 N 是 一 行 的 小 块 数 ，(row, coD 是 在 该 网 格 中 的 坐标 。 
在 @ 行 ， 利 用 前 面 的 公式 给 出 行 ，@ 行 给 出 了 列 。 






















































































































































































7.3.6 ”创建 照片 马赛 克 
现在 ， 有 了 所 有 必需 的 工具 方法 ， 让 我 们 编写 一 个 main 函数 , 创建 照片 马赛克 。 


def createPhotomosaic(target_image, input_images, grid_size, reuse_images=True): 


























creates a photomosaic given target and input images 


print('splitting input image...') 
# split the target image into tiles 
o target images = splitlImage(target image, grid size) 


print('finding image matches...') 
# for each tile, pick one matching input image 
output images - [] 
# for user feedback 
count - O 
e batch size = int(len(target images)/10) 
# calculate the average of the input image 
avgs = [] 
for img in input images: 
e avgs.append(getAverageRGB(img)) 


for img in target images: 
# compute the average RGB value of the image 
o avg = getAverageRGB(img) 
# find the matching index of closest RGB value 
# from a list of average RGB values 


e match index - getBestMatchIndex(avg, avgs) 

[5] output images.append(input images[match index]) 
# user feedback 

o if count > 0 and batch size > 10 and count % batch size is 0: 

print('processed %d of %d...' %(count, len(target images))) 

count *- 1 
# remove the selected image from input if flag set 

e if not reuse images: 


input images.remove(match) 
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print('creating mosaic...') 
# create photomosaic image from tiles 
9 mosaic_image = createImageGrid(output_images, grid_size) 


# display the mosaic 
return mosaic_image 


createPhotomosaic() 方 法 的 输入 是 目标 图 像 、 输 入 图 像 列 表 、 生 成 照片 马赛 元 的 
大 小 ， 以 及 一 个 标志 ， 该 标志 表明 图 像 是 否 可 以 复 用 。 在 @ 行 ， 它 将 目标 图 像 分 割 
成 一 个 网 格 。 图 像 被 分 割 后 ， 针 对 每 个 小 块 ， 从 输入 文件 夹 中 寻找 匹配 的 图 像 ( 因 
为 这 个 过 程 可 能 很 长 ， 所 以 提供 反馈 给 用 户 ， 让 他 们 知道 程序 仍 在 工作 )。 

在 @ 行 ， 将 batch size 设置 为 小 块 图 像 总 数 的 十 分 之 一 。 在 @ 行 ， 该 变量 将 用 
于 疝 用 户 更 新 信息 (选择 十 分 之 一 是 任意 的 ， 只 是 一 种 方式 让 程序 说 :“ 我 还 活着 。” 
每 次 程序 处 理 了 图 像 的 十 分 之 一 ， 就 打印 一 条 消息 ， 表 明 它 仍 在 运行 )。 

在 自行 , 为 输入 文件 夹 中 的 每 个 图 像 计 算 平均 RGB 值 ， 并 保存 在 列表 aves 中 。 
然后 ， 开 始 迭 代 遍 历 目标 图 像 网 格 中 的 每 个 小 块 。 对 于 每 个 小 块 ， 计 算 平均 RGB 
值 @9。 然 后 ， 在 @ 行 ， 在 输入 图 像 的 平均 值 列表 中 ， 寻 找 该 值 的 最 佳 匹 配 。 返 回 的 
结果 是 一 个 下 标 ， 在 @ 行 用 它 取 得 Image 对 象 ， 并 保存 在 列表 中 。 
在 @ 行 ， 每 处 理 batch size 个 图 像 ， 就 为 用 户 打 印 一 条 消息 。 在 @ 行 ， 如 果 
reuse images 标志 设置 为 False， 就 从 列表 中 删除 选 定 的 输入 图 像 ， 这 样 就 不 会 在 另 
一 个 小 块 中 重用 〈 如 果 有 广泛 的 输入 图 像 可 选 ， 这 种 方式 效果 最 好 )。 最 后 ， 在 @ 
行 ， 组 合 图 像 创建 最 终 的 照片 马赛 克 。 













































































































































































































































































































































































7.3.7 ”添加 命令 行 选项 
该 程序 的 main() 方 法 支持 这 些 命令 行 选项 : 
# parse arguments 


parser = argparse.ArgumentParser(description='Creates a photomosaic from 
input images') 





# add arguments 

parser.add argument('--target-image', dest-'target image', required=True) 
parser.add argument('--input-folder', dest-'input folder', required-True) 
parser.add argument('--grid-size', nargs-2, dest-'grid size', required-True) 
parser.add argument('--output-file', dest-'outfile', required-False) 


这 段 代 码 包含 3 个 必需 的 命令 行 参 数 : 目标 图 像 的 名 称 、 输 入 图 像 文件 夹 的 名 
称 ， 以 及 网 格 尺 寸 。 第 4 个 参数 是 可 选 的 文件 名 。 如 果 省 略 该 文件 名 ， 照 片 马赛 克 
将 写 入 文件 mosaic.png。 

















7.3.8 ”控制 照片 马赛 克 的 大 小 
要 解决 的 最 后 一 个 问题 是 照片 马赛 克 的 大 小 。 如 果 基 于 目标 图 像 中 匹配 的 小 
R, 盲目 地 将 输入 图 像 粘贴 在 一 起 ， 就 会 得 到 一 个 巨大 的 照片 马赛 元， 比 目 标 图 像 
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大 得 多 。 为 了 避免 这 种 情况 ， 调 整 输入 图 像 的 大 小 ， 以 匹配 网 格 中 每 个 小 块 的 大 小 
(这 样 做 还 有 一 个 好 处 ， 可 以 加 快 平均 RGB 的 计算 ， 因为 用 了 较 小 的 图 像 )。main() 
方法 也 进行 这 样 的 处 理 : 




































































print('resizing images...') 
# for given grid size, compute the maximum width and height of tiles 
o dims = (int(target image.size[0]/grid size[1]), 


int(target image.size[1]/grid size[0])) 
print("max tile dims: %s" % (dims,)) 
# resize 
for img in input_images: 
e img.thumbnail(dims) 


在 @ 行 ， 根 据 指定 的 网 格 大 小 ， 计 算 目 标 图 像 的 维度 。 随 后 ， 在 @@ 行 ， 用 PIL 
Image.thumbnail() 方 法 来 调整 图 像 ， 以 适应 网 格 的 大 小 。 



























































7.4 ”完整 代码 


项 目的 完整 代码 可 以 在 https://github.com/electronut/pp/tree/master/photomosaic/ 
photomosaic.py 找到 。 


import sys, os, random, argparse 
from PIL import Image 

import imghdr 

import numpy as np 


def getAverageRGB (image) : 


return the average color value as (r, g, b) for each input image 
# get each tile image as a numpy array 

im = np.array (image) 

# get the shape of each input image 

w,h,d = im.shape 

# get the average RGB value 

return tuple(np.average(im.reshape(w*h, d), axis=0)) 


def splitImage(image, size): 


given the image and dimensions (rows, cols), returns an m*n list of images 
W, H image.size[0], image.size[1] 
m, n size 
w, h = int(W/n), int(H/m) 
# image list 
imgs = [] 
# generate a list of dimensions 
for j in range(m): 
for i in range(n): 
# append cropped image 
imgs.append(image.crop((i*w, j*h, (i*1)*w, (j*1)*h))) 
return imgs 


def getImages(imageDir) 


98 Python 极 客 项 目 编程 


def 


def 


given a directory of images, return a list of Images 
files = os.listdir(imageDir) 
images = [] 
for file in files: 
FilePath = os.path.abspath(os.path.join(imageDir, file) ) 
try: 
# explicit load so we don't run into a resource crunch 
fp = open(filePath, "rb") 
im = Image.open(fp) 
images .append(im) 
# force loading image data from file 
im.load() 
# close the file 
fp.close() 
except: 
# skip 
print("Invalid image: %s" % (filePath, )) 
return images 


getImageFilenames(imageDir) 


given a directory of images, return a list of image filenames 
files = os.listdir(imageDir) 
filenames = [] 
for file in files: 
filePath = os.path.abspath(os.path.join(imageDir, file) ) 
try: 
imgType = imghdr.what(filePath) 
if imgType: 
filenames.append(filePath) 
except: 
# skip 
print("Invalid image: %s" % (filePath,)) 
return filenames 


getBestMatchIndex(input_avg, avgs): 


return index of the best image match based on average RGB value distance 


# input image average 
avg = input_avg 
# get the closest RGB value to input, based on RGB distance 
index = 0 
min_index = 0 
min dist = float("inf") 
for val in avgs: 
dist = ((val[0] - avg[0])*(val[0] - avg[0]) + 
(val[1] - avg[1])*(val[1] - avg[1]) + 
(val[2] - avg[2])*(val[2] - avg[2])) 
if dist « min dist: 
min dist - dist 
min index - index 
index *- 1 


return min index 
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def createImageGrid(images, dims): 


given a list of images and a grid size (m, n), create a grid of images 


m, n = dims 


# sanity check 
assert m*n == len(images) 


# get the maximum height and width of the images 
# don't assume they're all equal 

width = max([img.size[0] for img in images]) 
height = max([img.size[1] for img in images]) 


# create the target image 
grid img - Image.new('RGB', (n*width, m*height)) 


# paste the tile images into the image grid 
for index in range(len(images)): 
row - int(index/n) 
col - index - n*row 
grid img.paste(images[index], (col*width, row*height)) 


return grid img 


def createPhotomosaic(target image, input images, grid size, reuse images-True): 


creates photomosaic given target and input images 


print('splitting input image...') 
# split the target image into tiles 
target images = splitlImage(target image, grid size) 


print('finding image matches...') 

# for each tile, pick one matching input image 
output_images = [] 

# for user feedback 

count = 0 


batch_size = int(len(target_images) /10) 


# calculate the average of the input image 

avgs = [] 

for img in input_images: 
avgs.append(getAverageRGB (img) ) 


for img in target_images: 
# compute the average RGB value of the image 
avg = getAverageRGB (img) 
# find the matching index of closest RGB value 
# from a list of average RGB values 
match_index = getBestMatchIndex(avg, avgs) 
output images.append(input images[match index]) 
# user feedback 
if count > 0 and batch size > 10 and count % batch size is 0: 
print('processed %d of %d...' %(count, len(target images))) 
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count += 1 
# remove the selected image from input if flag set 
if not reuse_images: 

input_images.remove(match) 


print('creating mosaic...') 
# create photomosaic image from tiles 
mosaic_image = createImageGrid(output_images, grid_size) 


# display the mosaic 
return mosaic_image 


# gather our code in a main() function 

def main(): 
# command line arguments are in sys.argv[1], sys.argv[2], 
# sys.argv[0] is the script name itself and can be ignored 
# parse arguments 
parser = argparse.ArgumentParser(description='Creates a photomosaic from 

input images' ) 

# add arguments 
parser.add argument('--target-image', dest-'target image', required=True) 
parser.add argument('--input-folder', dest-'input folder', required-True) 
parser.add argument('--grid-size', nargs-2, dest-'grid size', required-True) 
parser.add argument('--output-file', dest-'outfile', required-False) 


args - parser.parse args() 
HHHHHE INPUTS ###### 


# target image 
target_image = Image.open(args.target_image) 


# input images 
print('reading input folder...') 
input_images = getImages(args.input_folder) 


# check if any valid input images found 


if input_images == []: 
print('No input images found in %s. Exiting.' % (args.input_folder, )) 
exit() 


# shuffle list to get a more varied output? 
random.shuffle(input images) 


# size of the grid 
grid size - (int(args.grid size[0]), int(args.grid size[1])) 


# output 
output filename - 'mosaic.png' 
if args.outfile: 
output filename - args.outfile 


# reuse any image in input 
reuse images - True 


# resize the input to fit the original image size? 
resize input - True 


##### END INPUTS ##### 
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print('starting photomosaic creation...') 


# if images can't be reused, ensure m*n <= num_of_images 
if not reuse_images: 
if grid_size[0]*grid_size[1] > len(input_images): 
print('grid size less than number of images') 
exit() 
# resizing input 
if resize_input: 
print('resizing images...') 
# for given grid size, compute the maximum width and height of tiles 
dims = (int(target_image.size[0]/grid_size[1]), 
int (target_image.size[1]/grid_size[0]) ) 
print("max tile dims: %s" % (dims,)) 
# resize 
for img in input_images: 
img.thumbnail(dims) 


# create photomosaic 
mosaic_image = createPhotomosaic(target_image, input_images, grid_size, 
reuse_images) 


# write out mosaic 
mosaic image.save(output filename, 'PNG') 


print("saved output to %s" % (output filename,)) 
print('done.') 


# standard boilerplate to call the main() function 
# to begin the program 
if name == ' gain ': 

main() 





7.5 ”运行 照片 马赛 死生 成 程序 
下 面 是 该 程序 的 运行 示例 : 


$ python photomosaic.py --target-image test-data/cherai.jpg --input-folder 
test-data/set6/ --grid-size 128 128 
reading input folder... 

starting photomosaic creation... 
resizing images... 

max tile dims: (23, 15) 

splitting input image... 

finding image matches... 

processed 1638 of 16384 ... 
processed 3276 of 16384 ... 
processed 4914 of 16384 ... 
creating mosaic... 

saved output to mosaic.png 

done. 


Fd 7-3 Ca) 展示 了 目标 图 像 ，(b) 展示 了 照片 马赛 列 。 在 《〈c)， 可 以 看 到 照片 
马赛 克 的 特写 。 
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(b) 





图 7-3 照片 马赛 克 运 行 示例 


7.6 “小 结 


在 这 个 项 目 中 ， 我 们 学 习 了 如 何 利 用 给 定 的 目标 图 像 和 一 组 输入 图 像 ， 创 建 一 
个 照片 马赛 克 。 从 远 处 看 ， 照 片 马赛 克 像 原来 的 图 像 ， 但 走 近 了 看 ， 可 以 看 到 各 个 
图 像 组 成 的 马赛 克 。 





7.7 实验 


这 里 有 一 些 方式 ， 可 以 进一步 探索 照片 马赛 克 。 

1. 编写 一 个 程序 ， 创 建 图 像 的 块 状 版 本 ， 类 似 图 7-1。 

2. 利用 本 章 的 代码 ， 通 过 粘贴 匹配 的 图 像 创 建 照片 马赛 元 ， 小 块 图 像 之 间 没 
有 间隙 。 更 艺术 的 表现 形式 ， 是 在 每 个 小 块 图 像 之 间 留 出 几 个 像素 的 均匀 间隙 。 如 
何 创 建 这 样 的 间隙 〈 提 示 : 在 计算 最 终 的 图 像 尺 寸 以 及 在 createImageGrid0 中 粘贴 
寸 ， 考 虑 间隙 的 因素 ) ? 

3. 程序 的 大 部 分 时 间 ， 用 于 从 输入 文件 夹 中 寻找 小 块 图 像 的 最 佳 匹配 。 为 
了 加 快 程序 ，getBestMatchIndex(O 需 要 运行 得 更 快 。 这 个 方法 是 对 平均 值 〈 看 成 
三 维 的 点 ) 列表 进行 简单 的 线性 搜索 。 这 个 任务 的 一 般 问 题 就 是 最 近邻 居 搜 索 。 
找到 最 近 点 有 一 种 特别 有 效 的 方法 ， 即 K-D 树 搜索 。SciPy 库 有 一 个 方便 的 类 
scipy.spatial.KDTree， 可 以 创建 K-D 并 向 它 查 询 最 近 点 的 匹配 。 请 尝试 用 SciPy 
的 K-D 树 蔡 代 线 性 搜索 (参见 http://docs.scipy.org/doc/scipy/reference/generated/ 
scipy.spatial.KDTree.html) 
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三 维 立体 画 


> m 




















是 着 图 8-1 看 一 分 钟 ,除了 随机 的 点 , 你 还 看 到 别 的 什么 吗 ? 
图 8-1 是 一 张 三 维 立体 画 ， 是 制造 三 维 假象 的 二 维 图 像 。 三 维 立 
体 画 通常 包含 一 些 重 复 的 图 案 ， 仔 细 观 察 会 被 大 脑 解 释 为 三 维 。 
如 果 你 看 不 到 任何 图 像 效 果 ， 别 担心 。 我 也 花 了 一 段 时 间 ， 做 了 
一 些 尝试 ， 才 能 看 到 《如 果 你 在 本 书 的 印刷 版 本 上 看 不 到 ， 请 在 
这 里 尝试 彩色 的 版 本 : https://github.com/electronut/pp/images/。 标 
题 的 脚注 提示 了 你 应 该 看 到 的 图 像 )。 
本 项 目 将 用 Python 创建 一 张 三 维 立体 画 。 下 面 是 本 项 目 涉及 的 一 些 概念 : 
。 线性 间距 和 深度 知觉 ; 
。 深度 图 ; 
。 用 Pillow 创建 和 编辑 图 像 ; 
e 用 Pillow 绘制 图 像 。 
本 项 目 生 成 的 三 维 立 体 画 设计 为 用 “ 墙 腿 ”方式 观看 。 看 到 它们 的 最 好 方法 ， 
就 是 让 眼睛 聚焦 在 图 像 后 面 的 点 (如 墙 上 )。 有 点 神奇 ,一旦 在 这 些 图 案 中 感知 到 
某 样 东 西 ， 眼 睛 就 会 自动 将 它 作 为 关注 的 焦点 ， 如 果 三 维 图 像 已 “锁定 ” 你 很 难 
对 它 视而不见 的 《如 果 你 仍然 无 法 看 到 图 像 ， 请 看 Gene Levin 的 文章 “How to View 
































































































































































































































































































































































































































8.1 


8.1.1 


Stereograms and Viewing Practice” 











工作 原理 





三 维 立体 画 的 工作 原理 是 改变 图 像 





图 8-1 -KAA RRB, TA 





7, RRYPHTERBD. 


























wo EMAZTEA P IS ECT ASR, CAD S DR 
个 图 案 和 不 同 的 间距 ， 尤 其 会 这 样 。 














感知 三 维 立体 画 中 的 深度 


AZ 





IRIS ZR 








让 你 感到 痛苦 





FE 间 距 ， 从 而 产生 深度 的 错 





E 解 释 为 深度 信息 ， 如 果 有 多 








如 果 你 的 眼睛 汇聚 在 图 像 背后 一 个 假想 的 点 ， 大 脑 将 左 眼看 到 的 一 些 点 与 右 腿 
























































看 到 的 男 一 些 点 匹配 起 来 ， 你 将 会 看 到 这 些 点 位 于 图 
用 的 感知 距离 取决 于 图 案 中 的 间 昌 
行 间 的 距离 相等 ， 但 它们 的 水 平 间 距 从 上 至 下 增加 。 


























像 之 后 的 一 个 平面 上 。 到 该 平 
EE 的 数量 。 例 如 ， 图 8-2 








展示 了 3 行 A。 这 些 A 每 





如 果 用 “ 墙 眼 ” 的 方式 来 看 ， 图 8-2 中 最 上 面 一 行 应 该 出 现在 纸 后 面 ， 中 间 行 
应 该 看 起 来 像 在 第 一 行 后 面 一 点 ， 底 部 一 行 应 该 出 现在 最 远 的 位 置 。 文 本 “floating 
text” 应 该 看 起 来 “ 浮 在 ”这 几 行 顶部 。 


























为 什么 大 脑 将 这 些 图 案 的 间 2 








E 解 读 为 深度 ? 



































通常 情况 下 , 如 果 看 远 处 的 物体 , 你 








的 双眼 协作 ， 育 焦 并 汇聚 在 同一 点 ， 双 眼 向 内 转 ， 直 接 指 向 目标 点 。 但 用 “ 墙 眼 ” 方 
式 观看 三 维 并 体 画 时 ， 聚 焦 和 汇聚 发 生 在 不 同 的 位 置 。 眼 睛 专注 于 三 维 立体 画 , 但 大 
脑 将 重复 的 模式 看 成 来 自 同一 个 虚拟 (虚构 的 ) 对 象 , 眼睛 汇聚 在 图 像 背 后 的 一 个 点 ， 
如 图 8-3 所 示 。 解 耦 的 聚焦 和 汇聚 县 加 在 一 起 ， 让 你 在 三 维 立体 画 中 看 到 深度 。 


















































(D http://colorstereo.com/texts_.txt/practice.htm 
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foatine text 





图 8-2 线性 间距 和 深度 知觉 


汇聚 : 感知 到 的 立体 物体 CR: 真实 距离 的 物体 


n 


聚焦 





8-3 在 三 维 立体 画 中 看 到 深度 
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近 的 


8.1.2 深度 图 


三 维 立 体 画 的 感 入 





间隔 ， 


“深度 





素 表示 的 对 
区 域 表 示 远 的 点 ， 如 








[深度 取决 于 像素 的 水 














已 出 现在 


图 ”是 这 相 
icit 
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E 离 。 














RERA 
图 8-4 所 示 。 





AMAT HATA. AM, 4 
将 认为 每 个 点 处 于 不 同 的 深度 ， 所 以 我 们 会 看 到 一 个 虚拟 


E 往 表现 为 一 





间距 。 因 
LR s SERT 
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图 像 ， 其 中 每 个 像素 的 值 表 示 深 





Se 


E 
的 三 维 图 








图 8-2 中 的 第 
图 像 中 是 变化 的 ， 大 脑 


























行 具有 最 














象 。 





度 值 ， 即 从 有 眼睛 到 该 像 











昌 灰 度 图 
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亮 的 区 域 表 示 近 的 点 ， 











































































































































































































































































































图 8-4 深度 图 

注意 ， 瘤 鱼 的 鼻子 是 图 像 中 最 亮 部 分 ， 似 乎 最 接近 你 。 朝 向 尾部 的 较 暗 区 域 看 
起 来 最 远 。 

因为 深度 图 表示 从 每 个 像素 中 心 到 眼睛 的 深度 或 距离 ， 所 以 可 以 用 它 来 获得 与 
图 像 中 像素 位 置 相 关联 的 深度 值 。 我 们 知道 ， 在 图 像 中 ， 水 平 偏 移 被 认为 是 深度 。 
所 以 ， 如 果 按 照 对 应 像素 值 深 度 值 的 比例 ， 来 偏 移 (图 案 〉 图 像 中 的 像素 ， 就 会 对 
该 像素 产生 与 深度 图 一 致 的 深度 知觉 。 如 果 对 所 有 像素 这 样 做 ， 最 终 就 会 将 整个 深 
度 图 编码 到 图 像 中 ， 生 成 三 维 立体 画 。 

深度 图 的 每 个 像素 存储 了 深度 值 ， 并 且 该 值 的 分 辨 率 取 决 于 表示 它 的 位 数 。 因 
为 本 章 采 用 常见 的 8 位 图 像 ， 深 度 值 的 范围 是 [0,255]。 

顺便 说 一 下 ， 图 8-4 中 的 图 像 就 是 用 于 创建 图 8-1 中 的 三 维 立体 画 的 深度 图 。 
你 很 快 就 能 学 会 自己 如 何 做 到 这 一 点 。 

该 项 目的 代码 将 遵循 以 下 步骤 ; 

1. 读 入 深度 图 ; 

2. 读 入 一 幅 平 铺 图 像 或 创建 一 个 “随机 点 ” 平 铺 图 像 ; 
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8.2 ”所 需 模块 


本 项 目 


3. 通过 习 








E 复 平 铺 图 像 创建 一 幅 新 图 像 。 该 图 像 的 尺寸 与 深度 图 一 致 ; 












































4. 对 新 图 像 中 的 每 个 像素 ， 根 据 该 像素 相关 联 的 深度 值 ， 将 它 按 比例 地 向 


右 移 





83 代码 


5. 将 三 维 立 体 画 写 入 一 个 文件 。 





























使 用 Pillow 读 取 图 片 ， 访 问 它们 的 底层 数据 ， 创 建 和 修改 图 像 。 














为 了 从 输入 的 深度 图 生成 三 维 立 体 画 ， 首 先 重 复 一 幅 给 定 的 平 铺 图 像 ， 生 成 一 
























































幅 中 间 图 像 。 接 下 来 ， 生 成 一 幅 充 满 随 机 点 的 平 铺 图 像 。 然 后 进入 生成 三 维 立体 画 





















































的 核心 代码 ， 即 利用 所 提供 的 深度 图 中 的 信息 ， 移 动 输入 的 图 像 。 要 查看 完整 的 项 























目 ， 请 直接 跳 到 8.4 节 。 








8.3.1 重复 给 定 的 平 铺 图 像 
我 们 从 利 
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o0 


NAR. Fg 















































] createTiledImage() 方 法 开始 ， 通 过 平 铺 一 个 图 形 文 件 ， 创 建 一 幅 新 




















像 尺寸 由 dims 元 组 指定 ， 该 元 组 形式 为 (width, height). 








# tile a graphics file to create an intermediate image of a set size 
def createTiledImage(tile, dims): 

# create the new image 

img - Image.new('RGB', dims) 

W, H = dims 

w, h = tile.size 

# calculate the number of tiles needed 

cols = int(W/w) + 1 

rows = int(H/h) + 1 

# paste the tiles into the image 

for i in range(rows): 

for j in range(cols): 


img 


.paste(tile, (j*w, i*h)) 


# output the image 
return img 











在 @ 行 ， 利 用 提供 的 尺寸 Cdims) 创建 新 的 Python 图 像 库 (PIL) Image 对 


象 。 新 图 





的 行 数 ， 





果 输 出 图 


像 的 


图 像 和 输出 文 














尺寸 由 元 组 dims 给 出 ， 形 式 是 (width，height)。 接 着 ， 保 存 平 铺 
牛 的 宽度 和 高 度 。 在 @ 行 ， 确 定 列 数 ， 在 @ 行 ， 确 定 中 间 图 像 所 需 






































方法 
像 的 














是 用 最 终 图 像 的 尺寸 除 以 平 铺 图 像 的 尺寸 。 除 的 结果 每 次 加 1， 如 
尺寸 不 是 正好 是 平 铺 图 像 的 整数 倍 , 这 也 能 确保 右边 最 后 的 平 铺 图 









































像 不 会 缺失 。 如 果 没 有 这 种 预防 措施 ， 图 像 的 右边 可 能 被 切断 。 然 后 ， 在 @ 行 ， 
循环 遍历 行 和 列 ， 并 用 平 铺 图 像 填 充 它们 。 通 过 乘积 G*w, i*h), 确定 平 铺 图 像 左 
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上 角 的 位 置 , 这 样 它 能 对 准 行 和 列 。 完 成 后 , 该 方法 返回 指定 尺寸 的 Image 对 象 ， 



































3 输入 图 像 tile 平 铺 。 








8.3.2 ”从 随机 圆 创建 平 铺 图 像 
如 果 用 户 不 提供 平 铺 
张 平 铺 图 像 。 


# create an image tile filled with random circles 
def createRandomTile(dims): 
# create image 
o img - Image.new('RGB', dims) 
e draw = ImageDraw.Draw(img) 
# set the radius of a random circle to 1% of 
# width or height, whichever is smaller 
















































































e r - int(min(*dims)/100) 
# number of circles 
o n = 1000 


# draw random circles 
for i in range(n): 
# -r makes sure that the circles stay inside and aren't cut off 
# at the edges of the image so that they'll look better when tiled 


e X, y = random.randint(O, dims[0]-r), random.randint(O, dims[1]-r) 
© fill = (random.randint(0, 255), random.randint (0, 255), 
random.randint(0, 255)) 
o draw.ellipse((x-r, y-r, x*r, y*r), fill) 
return img 











在 @ 行 , 用 dim 给 出 的 尺寸 创建 新 的 Image 对 象 Hl ImageDraw.Draw() 四 在 该 
图 像 中 画 圆 圈 ， 用 宽 或 高 中 较 小 值 的 1/100 作为 半径 ， 画 圆圈 上 日 (Python 的 * 运 算 符 





















































将 dim 元 组 中 的 宽度 和 高 度 值 解 包 ， 这 样 就 能 传 入 到 min() 方 法 中 )。 























图 像 ， 就 利用 createRandomTile() 方 法 ， 用 随机 圆圈 创建 一 


在 @ 行 ,设置 要 画 的 圆圈 数 为 1000。 然 后 调用 random.randint0， 获 得 范围 为 [0， 











width-r] 和 [0, height-r] 的 两 个 随机 整数 ， 从 而 算出 每 个 圆圈 的 x 和 y 坐标 @。“-r” 确 
保生 成 的 圆圈 保持 在 width X height 的 图 像 矩 形 内 部 。 不 带 -T， 画 的 圆圈 可 能 就 在 图 
















































































像 边 缘 ， 这 意味 着 它 会 被 切 掉 一 部 分 。 如 果 平 铺 这 样 的 图 像 来 创建 三 维 立 体 画 ， 乡 
果 不 会 好 看 ， 因 为 两 个 平 铺 图 像 之 间 没 有 空间 。 










































































要 生成 一 个 随机 圆圈 ， 先 画 出 轮 廊 ， 然 后 填充 颜色 。 在 @ 行 ， 在 [0,255] 的 范围 
内 随机 选取 RGB 值 ， 用 选择 颜色 填充 。 最 后 ， 在 @ 行 ， 用 draw 中 的 ellipse0 方 法 
























































绘制 每 个 圆圈 。 该 方法 的 第 一 个 参数 是 圆 的 边界 矩形 ， 它 由 左上 角 和 右 下 角 指 定 ， 
分 别 为 (x-r, y-r) 和 (x+r, y+r)， 其 中 (x, y) 是 该 圆 的 圆心 ，r 是 半径 。 
让 我 们 在 Python 解释 器 中 测试 这 种 方法 。 


>>> import autos 

>>> img = autos.createRandomTile((256, 256)) 
>>> img.save('out.png') 

>>> exit() 
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8.3.3 





创建 的 三 维 立体 画 。 





图 8-5 展示 了 测试 的 输出 。 








8-5 尝试 运行 createRandomTile() 


正如 你 在 图 8-5 中 看 到 的 ， 我 们 已 经 创建 了 随机 点 的 平 铺 图 像 。 可 以 使 用 



























































创建 三 维 立体 画 











它 来 


现在 ， 让 我 们 创建 一 些 三 维 立 体 画 。createAutostereogram() 方 法 完成 了 大 部 分 














工作 ， 如 下 所 示 : 


def createAutostereogram(dmap, tile): 


# convert the depth map to a single channel if needed 
if dmap.mode is not 'L': 
dmap = dmap.convert('L') 
# if no image is specified for a tile, create a random circles tile 
if not tile: 
tile = createRandomTile((100, 100)) 
# create an image by tiling 
img = createTiledImage(tile, dmap.size) 
# create a shifted image using depth map values 
sImg - img.copy() 
# get access to image pixels by loading the Image object first 
pixD = dmap.load() 
pixS = sImg.load() 
# shift pixels horizontally based on depth map 
cols, rows = sImg.size 
for j in range(rows): 
for i in range(cols): 
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xshift = pixD[i, j]/10 
xpos = i - tile.size[0] + xshift 
if xpos > 0 and xpos < cols: 
pixS[i, j] = pixS[xpos, j] 
# display the shifted image 
return SImg 


在 @ 行 ， 进 行 完整 性 检查 ， 确 保 深度 图 和 图 像 具 有 相同 的 尺寸 。 在 四 行 ， 如 果 
用 户 没 有 提供 平 铺 图 像 ， 就 创建 随机 圆圈 平 铺 图 像 。 在 上 日 行 ， 创 建 一 张 平 铺 好 的 图 
像 ， 符 合 提供 的 深度 图 的 大 小 。 然 后 ， 在 @ 行 生成 这 张 平 铺 好 的 图 像 的 副本 。 
在 @ 行 ， 调 用 Image.load(0 方 法 ， 将 图 像 数据 加 载 到 内 存 中 。 该 方法 允许 用 形 如 
[i, j] 的 三 维 数组 来 访问 图 像 像 素 。 在 @ 行 ， 将 图 像 的 尺寸 保存 为 行 数 和 列 数 ， 将 图 
像 看 成 单个 像素 构成 的 网 格 。 

三 维 立 体 画 创建 算法 的 核心 在 于 ， 根 据 从 深度 图 中 收集 的 信息 ， 移 动 平 铺 图 像 
中 像素 的 方式 。 要 做 到 这 一 点 ， 遍 历 平 铺 图 像 ， 处 理 每 一 个 像素 。 在 @ 行 ， 根 据 深 
FEA pixD 中 的 相关 像素 ， 查 找 偏 移 的 值 。 然 后 将 这 个 深度 值 除 以 10， 因 为 这 里 用 
的 是 8 位 深度 图 ， 这 意味 着 深度 的 范围 是 0 到 255。 如 果 除 以 10， 得 到 的 深度 值 范 
围 是 0 到 25。 由 于 深度 图 输入 图 像 的 尺寸 通常 是 几 百 像素 ， 所 以 这 些 偏 移 值 很 合适 
尝试 改变 除数 ， 看 看 它 如 何 影响 最 终 图 像 )。 
在 @ 行 ， 计 算 像 素 的 新 x 位置， 用 平 铺 图 像 填 充 三 维 立体 画 。 每 隔 w 个 像素 ， 
像素 的 值 不 断 重复 ， 由 公式 ai = ai + w 表示 ， 其 中 的 a 是 在 x 轴 下 标 i 处 的 给 定 像 
素 的 颜色 〈 因 为 考虑 的 是 像素 行 ， 而 不 是 列 ， 所 以 忽略 y 方 向 )。 

要 创建 深度 感 ， 就 要 让 间隔 (或 重复 的 间距 ) 与 该 像素 的 深度 图 值 成 正比 。 这 
样 在 最 终 的 三 维 立体 画图 像 中 ， 每 个 像素 和 它 前 一 次 (周期 地 ) 出 现 相 比 ， 偏 移 了 
delta i。 这 可 以 表示 为 b; = b, w3, 

ZE, b 表示 最 后 的 三 维 立体 画图 像 中 ， 下 标 i 处 给 定 像素 的 颜色 值 。 这 正 是 
@ 行 所 做 的 事 。 深 度 图 值 为 0 (BE) 的 像素 没有 偏 移 ， 被 视 为 背景 。 
在 @ 行 ， 用 偏 移 的 值 蔡 换 每 个 像素 。 在 @ 行 ， 检 查 确保 没有 试图 访问 不 在 图 像 
中 的 像素 ， 因 为 偏 移 ， 在 图 像 边缘 可 能 发 生 这 种 情况 。 


eooQ 









































































































































































































































































































































































































































































































































































































































8.3.4 ”命令 行 选项 
现在 ， 我 们 来 看 看 该 程序 的 main0 方 法 ， 其 中 提供 了 一 些 命令 行 选项 。 


# create a parser 




















parser = argparse.ArgumentParser(description-"Autosterograms...") 
# add expected arguments 
o parser.add_argument('--depth', dest='dmFile', required=True) 


parser.add_argument('--tile', dest='tileFile', required=False) 
parser.add_argument('--out', dest='outFile', required=False) 

# parse args 

args = parser.parse_args() 

# set the output file 

outFile = 'as.png' 
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8.4 


if args.outFile: 
outFile = args.outFile 
# set tile 


tileFile 


= False 


if args.tileFile: 
tileFile = Image.open(args.tileFile) 


在 @ 行 ， 














像 以 前 的 项 目 一 样 ， 利 用 argparse 为 程序 定义 了 一 些 命令 行 选项 。 一 

















个 必需 的 参数 是 深度 图 文件 ， 两 个 可 选 的 参数 是 平 铺 图 像 文件 名 和 输出 文件 名 。 如 
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果 未 指定 平 铺 图 像 ， 程 序 会 生成 随机 圆圈 平 铺 图 像 。 如 果 未 指定 输出 文件 名 ， 则 三 
维 立体 画 会 输出 到 as.png 文件 。 
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完整 代码 












































下 面 是 完整 的 三 维 立 体 画 程序 。 也 可 以 从 https://github.com/electronut/pp/blob/ 
master/autos/autos.py 下 载 这 段 代 码 。 


import sys, random, argparse 
from PIL import Image, ImageDraw 


# create spacing/depth example 
def createSpacingDepthExample(): 


tiles = [Image.open('test/a.png') 


, Image.open('test/b.png'), 
Image.open('test/c.png')] 


img - Image.new('RGB', (600, 400), (0, O, 0)) 


Spacing - 


[10, 20, 40] 


for j, tile in enumerate(tiles): 
for i in range(8): 
img.paste(tile, (10 + i*(100 + j*10), 10 + j*100)) 
img.save('sdepth.png') 


# create an image filled with random circles 
def createRandomTile(dims) : 


# create 


image 


img = Image.new('RGB', dims) 

draw = ImageDraw.Draw(img) 

# set the radius of a random circle to 1% of 
# width or height, whichever is smaller 

r = int(min(*dims)/100) 


# number of circles 

n = 1000 

# draw random circles 

for i in range(n): 
# -r makes sure that the circles stay inside and aren't cut off 
# at the edges of the image so that they'll look better when tiled 
X, y = random.randint(0, dims[0]-r), random.randint(O, dims[1]-r) 
fill = (random.randint(0, 255), random.randint(0, 255), 

random.randint(0, 255) ) 

draw.ellipse((x-r, y-r, x*r, y*r), fill) 

# return image 

return img 


# tile a graphics file to create an intermediate image of a set size 
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def createTiledImage(tile, dims): 
# create the new image 
img - Image.new('RGB', dims) 
W, H = dims 
w, h = tile.size 
# calculate the number of tiles needed 
cols = int(W/w) + 1 
rows = int(H/h) + 1 
# paste the tiles into the image 
for i in range(rows): 
for j in range(cols): 
img.paste(tile, (j*w, i*h)) 
# output the image 
return img 


# create a depth map for testing 

def createDepthMap(dims): 
dmap = Image.new('L', dims) 
dmap.paste(10, (200, 25, 300, 125)) 
dmap.paste(30, (200, 150, 300, 250)) 
dmap.paste(20, (200, 275, 300, 375)) 
return dmap 


# given a depth map image and an input image, 
# create a new image with pixels shifted according to depth 
def createDepthShiftedImage(dmap, img): 

# size check 

assert dmap.size -- img.size 


# create shifted image 
sImg - img.copy() 
# get pixel access 
pixD = dmap.load() 
pixS = sImg.load() 
# shift pixels output based on depth map 
cols, rows = sImg.size 
for j in range(rows): 
for i in range(cols): 
xshift = pixD[i, j]/10 
xpos = i - 140 + xshift 
if xpos > 0 and xpos < cols: 
pixS[i, j] = pixS[xpos, j] 
# return shifted image 
return sImg 


# given a depth map (image) and an input image, 
# create a new image with pixels shifted according to depth 
def createAutostereogram(dmap, tile): 
# convert the depth map to a single channel if needed 
if dmap.mode is not 'L': 
dmap = dmap.convert('L') 
# if no image is specified for a tile, create a random circles tile 
if not tile: 
tile = createRandomTile((100, 100)) 
# create an image by tiling 
img - createTiledImage(tile, dmap.size) 
# create a shifted image using depth map values 
sImg - img.copy() 
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8.5 


# get access to image pixels by loading the Image object first 


pixD = dmap.load() 

pixS = sImg.load() 

# shift pixels horizontally based on depth map 

cols, rows = sImg.size 

for j in range(rows): 

for i in range(cols): 
xshift = pixD[i, j]/10 
xpos = i - tile.size[0] + xshift 
if xpos » O and xpos « cols: 
pixS[i, j] = pixS[xpos, j] 
# return shifted image 
return sImg 


# main() function 
def main(): 


# use sys.argv if needed 
print('creating autostereogram...') 
# create parser 


parser = argparse.ArgumentParser (description="Autosterograms...") 


# add expected arguments 


parser.add argument('--depth', dest-'dmFile', required=True) 
parser.add argument('--tile', dest-'tileFile', required-False) 
parser.add argument('--out', dest-'outFile', required-False) 


# parse args 
args - parser.parse args() 
# set the output file 
outFile = 'as.png' 
if args.outFile: 
outFile = args.outFile 
# set tile 
tileFile = False 
if args.tileFile: 
tileFile = Image.open(args.tileFile) 
# open depth map 
dmImg = Image.open(args.dmFile) 
# create stereogram 
asImg = createAutostereogram(dmImg, tileFile) 
# write output 
asImg.save(outFile) 


# call main 


if 
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运行 三 维 立 体 画 生成 程序 











$ python3 autos.py --depth data/stool-depth.png 


供 


























图 像 ， 这 张 三 维 立体 画 使 用 了 随机 生成 的 平 铺 











m.: 





现在 ， 我 们 用 合子 (stool-depth.png〉 的 深度 图 运行 该 程序 。 





图 像 。 























图 8-6 左边 展示 了 深度 图 ， 右 边 展示 了 生成 的 三 维 立体 画 。 因 为 没有 为 平 铺 提 























8-6 ”autos.py 运行 示例 
现在 ,让 我 们 给 定 一 个 平 铺 图 像 作为 输入 。 像 前 面 一 样 使 用 stool-depth.png 深 度 
图 ， 但 这 一 次 ， 提 供 图 像 escher-tile.jpe“ 作为 平 铺 图 像 。 
$ python3 autos.py --depth data/stool-depth.png —tile data/escher-tile.jpg 


图 8-7 展示 了 输出 。 
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8-7 18) 488 45.05 autos. py 运行 示例 





(D http://calculus-geometry.hubpages.com/hub/Free-M-C-Escher-Tessellation-Background-Patterns-Tiling-Lizard-Background/ 
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8.6 ”小结 
在 本 项 目 中 ， 我 们 学 习 了 如 何 创 
可 以 创建 随机 点 的 三 维 立体 画 ， 或 用 提供 的 图 像 来 平 铺 。 
87 实验 





























些 方法 ， 可 以 ; 








步 探索 三 维 立体 画 。 

















这 里 有 
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幻觉 《提示 : Fil 
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图 像 平 铺 和 Image.paste077 152. 











.编程 创建 类 似 图 8-2 的 图 像 ， 演 示 图 像 中 线性 间距 的 变化 如 





2. 为 程序 添加 一 个 命令 行 选项 ， 指 定 应 用 于 深度 图 值 的 比例 ( 











码 中 深度 图 值 除 以 10)。 变 更 如 何 影响 到 三 维 立体 画 ? 
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建 三 维 立体 画 。 给 定 深 度 图 的 图 像 ， 我 们 现在 





可 制造 深度 的 








IZ—F, AR 


3. 学 习 用 SketchUp 这 样 的 工具 ， 创 建 自己 的 三 维 模型 深度 图 Chttp://sketchup. 

















com/)， 或 在 线 访问 许多 现成 的 SketchUp 模型 。 利 ) 

















] SketchUp 的 Fog 选项 来 创建 


你 的 深度 图 。 如 需 帮 助 , 看 看 这 个 YouTube 视频 : https://www.youtube.com/watch?v= 








fDzNJYi6Bok/. 
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第 四 部 分 


走 进 二 维 


“在 一 维 中 ， 移 动 一 个 点 难道 不 是 产生 了 有 两 个 端点 的 线段 ? 
在 两 维 中 ， 移 动 一 段 线 难道 不 是 产生 了 有 四 个 端点 的 正方 形 ? 
在 三 维 中 ， 移 动 一 个 正方 形 难道 不 是 产生 了 《我 的 眼睛 没有 看 见 ) 
那 种 神奇 的 造物 ， 立 方 体 ， 有 八 个 端点 ? ” 
一 一 Edwin A. Abbott, Flatland: A Romance of Many Dimensions 
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理解 OpenGL 





本 项 目 将 创建 一 个 简单 的 程序 ， 利 用 OpenGL 和 GLFW 来 
显示 纹理 贴图 的 正方 形 。OpenGL 为 图 形 处 理 单元 (GPU) 增加 
了 一 个 软件 接口 ， 而 GLFW 是 一 个 窗口 工具 包 。 我 们 还 将 学 习 
如 何 使 用 类 似 C 语言 的 OpenGL 着 色 语 言 (GLSL) 来 编写 着 色 
器 ， 即 在 GPU 上 执行 的 代码 。 着 色 器 为 OpenGL 中 的 计算 带 来 
巨大 的 灵活 性 ,我 会 展示 如 何 用 GLSL 着 色 器 来 变换 几何 图 形 并 

， 创 建 一 个 旋转 的 、 带 纹理 的 多 边 形 (如 图 9-1 Bm 2. 
GPU 经 过 优化 ， 以 并 行 的 方式 对 大 量 数据 反复 地 执行 相同 的 操作 ,这 让 它们 在 
做 这 样 的 工作 时 ， 比 中 央 处 理 单元 (CPU) 快 得 多 。 除 了 演 染 计算 机 图 形 ， 它 们 也 
用 于 通用 计算 ， 现 在 有 一 些 专门 的 语言 让 你 用 GPU 硬件 完成 这 样 的 工作 。 本 项 目 
将 利用 GPU. OpenGL 和 着 色 器 。 

Python 是 一 种 极 好 的 “胶水 ”语言 。 对 于 其 他 语言 《如 C 语言 ) 编写 的 库 ， 有 
大 量 的 Python 绑 定 ， 让 你 在 Python 中 使 用 它们 。 本 章 和 第 10 章 、 第 11 章 ， 将 使 
] PyOpenGL， 即 OpenGL 的 Python 绑 定 ， 来 创建 计算 机 图 形 。 

OpenGL 是 一 个 “状态 机 ” 有 点 像 一 个 电器 开关 ， 有 两 种 状态 : 开 和 关 。 如 果 
从 一 种 状态 切换 到 另 一 种 ， 开 关 就 保持 在 这 种 新 状态 。 人 然而，OpenGL 比 简单 的 电 
器 开关 更 复杂 , 它 更 像 一 个 交换 机 ， 有 许多 开关 和 表盘 。 一 旦 更 改 特定 设置 的 状态 
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它 就 保持 为 关 ， 直 到 你 打开 。 如 果 一 个 OpenGL 调用 绑 定 到 某 个 对 象 上 了 ， 那 随后 
的 相关 调用 都 会 发 送 给 这 个 对 象 ， 直 到 解除 绑 定 。 








eoo simpleglfw 





9-1 AERAERMRARR-SREN SAY, CHA-+EUAR. 
利用 着 色 器 ， 这 个 方形 的 多 边 形 边界 被 剪裁 成 一 个 黑色 圆圈 


下 面 是 本 项 目 引 入 的 一 些 概念 : 
使 用 针对 OpenGL 的 GLFW 窗口 库 ; 
使 用 GLSL 编写 顶点 和 片段 着 色 器 ; 
进行 纹理 贴图 ; 

使 用 三 维 变换 。 

首先 ， 我 们 来 看 看 OpenGL 的 工作 原理 。 

















9.1 老式 OpenGL 


在 大 多 数 计算 机 图 形 系统 中 ， 绘 图 的 方式 是 将 一 些 顶 点 发 送 给 处 理 管线 ， 管 线 
由 一 系列 功能 模块 互相 连接 而 成 。 最近，OpenGL 应 用 编程 接口 (API) 从 固定 功能 
的 图 形 管线 转 为 可 编程 的 图 形 管线 。 我 们 将 专注 于 现代 的 OpenGL， 但 因为 在 网 络 
上 会 看 到 许多 “老式 ”OpenGL 的 例子 ， 我 会 让 你 看 看 这 个 API 过 去 的 样子 ， 以 更 
好 地 感受 所 发 生 的 变化 。 




















122 Python 极 客 项 目 编程 








例如 ， 下 面 这 个 简单 的 老式 OpenGL 程序 在 屏幕 上 绘制 一 个 黄色 的 矩形 。 


import sys 
from OpenGL.GLUT import * 
from OpenGL.GL import * 




















def display(): 
glClear (GL COLOR BUFFER BIT|GL DEPTH BUFFER BIT) 
glColor3f (1.0, 1.0, 0.0) 
glBegin(GL QUADS) 
glVertex3f (-0.5, -0.5, 0.0) 





glVertex3f (0.5, -0.5, 0.0) 
glVertex3f (0.5, 0.5, 0.0) 
glVertex3f (-0.5, 0.5, 0.0) 
glEnd() 


glFlush(); 


glutInit(sys.argv) 
glutInitDisplayMode(GLUT SINGLE|GLUT RGB) 
glutInitWindowSize(400, 400) 
glutCreateWindow("oldgl") 

glutDisplayFunc (display) 

glutMainLoop() 


图 9-2 展示 了 结果 。 








eoo X! oldgl 





9-2 简单 的 老式 OpenGL 程序 的 输出 
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使 用 老式 OpenGL， 要 为 三 维 图 元 在 这 个 例子 中 ， 是 一 个 GL QUAD. BFE 
EO 指定 各 个 顶点 ， 但 随后 每 个 顶点 需要 被 分 别 发 送 到 GPU， 这 是 低 效 的 方式 。 这 
种 老式 编程 模式 伸缩 性 不 好 ， 如 果 几 何 图 形变 得 复杂 ， 程 序 就 会 很 慢 。 对 于 屏幕 上 
的 顶点 和 像素 如 何 变 换 ， 它 只 提供 有 限 的 控制 (在 本 项 目 中 可 以 看 到 ， 用 新 的 可 编 
程 管线 的 范式 ， 可 以 克服 这 些 限制 )。 
































































































































9.2 ”现代 OpenGL: 三 维 图 形 管线 
为 了 让 你 感受 现代 OpenGL 如 何在 较 高 层面 上 工作 ,让 我 们 利用 一 系列 的 操作 ， 
即 通常 所 谓 的 “三 维 图 形 管线 ”, 在 屏幕 上 画 一 个 三 角形 。 图 9-3 给 出 了 OpenGL 三 
维 图 形 管线 的 简化 表示 。 
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三 维 几 何 图 形 定义 〈VBO 等 ) —- | 顶点 着 色 器 | — xm 
片段 着 色 器 — | 帧 缓冲 区 操作 〈 深 度 测 试 、 混 和 等 ) —- 帧 缓冲 区 


























图 9-3 (简化 的 ) OpenGL 图 形 管线 

在 第 一 步 ， 通 过 定义 在 三 维 空间 中 的 三 角形 的 顶点 ， 并 指定 每 个 顶点 相关 联 的 
颜色 ， 我 们 定义 了 三 维 几 何 图 形 。 接 下 来 ， 变 换 这 些 顶 点 : 第 一 次 变换 将 这 些 顶 点 
放 在 三 维 空间 中 ， 第 二 次 变换 将 三 维 坐标 投影 到 二 维 空间 。 根 据 照 明 等 因素 ， 对 应 
顶点 的 颜色 值 也 在 这 一 步 中 计算 ， 这 在 代码 中 通常 称 为 “顶点 着 色 器 ”。 

接着 ， 将 几何 图 形 “ 光 栅 化 ”〈 从 几何 物体 转换 为 像素 )， 针 对 每 个 像素 ， 执 行 
另 一 个 名 为 “片段 着 色 器 ”的 代码 块 。 正 如 顶点 着 色 器 作用 于 三 维 顶 点 ， 片 段 着 色 
器 作用 于 光栅 化 后 的 二 维 像素 。 

最 后 ， 像 素 经 过 一 系列 帧 缓冲 区 操作 ， 其 中 ， 它 经 过 “深度 缓冲 区 检验 ”( 检 
查 一 个 片段 是 否 遮 挡 另 一 个 )“ 混 合 ”( 用 透明 度 混合 两 个 片段 ) 以 及 其 他 操作 ， 
其 当前 的 颜色 与 帧 缓冲 区 中 该 位 置 已 有 的 颜色 结合 。 这 些 变 化 最 终 体 现在 最 后 的 帧 
缓冲 区 上 上， 通常 显示 在 屏幕 上 。 
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9.2.1 几何 图 元 
因为 OpenGL 是 一 个 底层 图 形 库 ， 你 不 能 要 求 它 直接 画 出 一 个 立方 体 或 球体 ， 
但 建立 在 它 之 上 的 库 可 以 完成 这 样 的 任务 。OpenGL 只 理解 底层 的 几何 图 元 ， 如 点 、 
线 和 三 角形 。 
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现代 OpenGL 只 支持 GL. POINTS, GL LINES. GL LINE STRIP. GL_LINE_ 
LOOP, GL TRIANGLES, GL TRIANGLE STRIP fil GL. TRIANGLE. FAN 等 图 元 
类 型 。 图 9-4 展示 了 图 元 的 顶点 是 如 何 组 织 的 。 显 示 的 每 个 顶点 是 一 个 三 维 坐标 ， 



































FHI, y, Z)o 
VO o 
` GL_POINTS 
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GL LINES GL LINE LOOP GL LINE STRIP 
vo v2 v4 v3 vo v4 
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v0 
vi v2 v1 
vl v2 
GL_TRIANGLES GL_TRIANGLE_STRIP GL_TRIANGLE_FAN 
vO 
v2 
v2 v5 v0 v4 
v1 
v3 rd \ vi 
v1 v4 v3 





图 9-4 OpenGL 的 图 元 
要 在 OpenGL 中 绘制 球体 ， 首 先 要 在 数学 上 定义 球体 的 几何 图 形 ， 并 计算 其 三 
全 顶点 。 然 后， 将 这 些 顶 点 组 合 为 基本 的 几何 图 元 。 例 如 ， 可 以 将 每 组 三 个 顶点 组 
成 一 个 三 角形 。 然 后 ， 可 以 用 OpenGL 演 染 这 些 顶 点 。 
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不 学 三 维 变换 ， 就 不 懂 计 算 机 图 形 学 。 三 维 变换 的 概念 都 很 简单 易 懂 。 你 有 
个 物体 ， 能 对 它 做 怎么 呢 ? 可 以 移动 、 拉 伸 《〈 或 挤 压 ) 或 旋转 。 也 可 以 做 其 他 事情 ， 
但 这 3 个 任务 是 物体 最 常见 的 操作 或 变换 : 平移 、 缩 放 和 旋转 。 除 了 这 些 常 用 的 变 
换 ， 还 得 用 透视 投影 将 三 维 物体 映 冉 到 屏幕 的 二 维 平面 。 这 些 变 换 都 应 用 于 你 要 变 
换 的 物体 上 。 

虽然 你 可 能 熟悉 〈x, y, z) 形式 的 三 维 坐 标 ， 但 在 三 维 计算 机 图 形 中 使 用 On y, 
z, W) 形式 的 坐标 ， 即 齐 次 坐标 〈 这 些 坐 标 来 自 数 学 的 一 个 分 文 ， 即 射影 几何 ， 这 
超出 了 本 书 的 范围 )。 
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其 次 坐标 允许 用 4X4 的 矩阵 来 表示 这 些 常见 的 三 维 变换 。 但 对 于 这 些 OpenGL 
项 目 ， 你 只 要 知道 齐 次 坐标 Ox, y, z, w) 相当 于 三 维 坐 标 (x/w, y/w, z/w, 1.0)。 三 维 的 
点 《1.0, 2.0, 3.0) 可 以 用 齐 次 坐标 表示 为 〈1.0, 2.0, 3.0, 1.0)。 

下 面 是 用 变换 矩阵 进行 三 维 变换 的 一 个 例子 。 看 看 矩阵 乘法 如 何 将 一 个 点 (x, y, 
z, 1.0) E43 + tx, y + ty, z + tz, 1.0)。 
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f£ OpenGL 中 经 常会 遇 到 两 个 术语 : 模型 视图 变换 和 投影 变换 。 随 着 现代 
OpenGL 中 可 定制 的 着 色 器 的 问世 ， 模 型 视图 和 投影 都 只 是 普通 的 变换 。 从 历史 上 
看 ， 在 老式 OpenGL 版 本 中 ， 模 型 视图 变换 用 于 三 维 模型 ， 将 它 置 于 空间 中 ， 而 投 
影 变 换 将 三 维 坐标 映射 到 二 维 平 面 ， 用 于 显示 ， 你 会 马上 看 到 模型 视图 变换 是 用 
户 定 义 的 变换 ， 让 你 放置 三 维 物 体 ， 投 影 变 换 是 三 维 映射 到 二 维 的 变换 。 

两 种 最 常用 的 三 维 图 形 投影 变换 是 “ 正 投 影 ” 和 “透视 投影 ” 但 这 里 只 会 用 
到 透视 投影 ， 这 是 由 “视角 ”( 眼 睛 能 看 到 的 范围 )、“ 近 裁剪 平面 ”( 最 接近 眼睛 的 
平面 )“ 远 裁剪 平面 ”( 离 眼睛 最 远 的 平面 ) 和 “纵横 比 ”(〈 近 平面 的 宽度 与 高 度 之 
比 〉 来 确定 的 。 这 些 参数 共同 构成 了 一 个 摄像 机 模型 ， 决 定 了 三 维 形状 如 何 映射 到 
二 维 屏幕 上 ， 如 图 9-5 所 示 。 图 中 的 截 头 金字 塔 是 “ 视 景 体 “眼睛 ”是 摄像 机 的 
三 维 位 置 ( 对 于 正 投影 ， 眼 睛 将 在 无 穷 远 处 ， 金 字 塔 将 变 成 长 方 体 )。 












































































































































































































































































































































视 景 体 


远 裁剪 平面 





视角 【垂直 的 ) re 


图 9-5 透视 投影 摄像 机 模型 
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透视 投影 完成 后 ， 在 光栅 扫描 之 前 ， 图 元 将 会 被 远近 裁剪 平面 切割 〈 或 剔除 )， 
如 图 9-5 所 示 。 远 近 裁 剪 平面 的 选择 ， 要 让 希望 出 现在 屏幕 上 的 三 维 物体 位 于 视 景 
体 之 内 ， 和 否则 ， 它 们 将 被 裁剪。 



































9.2.3 着色 器 
你 已 见 过 着 色 器 如 何 融入 现代 OpenGL 的 可 编程 图 形 管线 了 。 现 在 ， 我 们 来 看 
看 一 对 简单 的 顶点 和 片段 着 色 器 ， 了 解 GLSL 的 工作 原理 。 


顶点 着 色 器 
下 面 是 一 个 简单 的 顶点 着 色 器 : 


#version 330 core 























































































































© 


@ in vec3 aVert; 


© uniform mat4 uMVMatrix; 
© uniform mat4 uPMatrix; 


© out vec4 vCol; 


void main() { 
// apply transformations 


e gl Position - uPMatrix * uMVMatrix * vec4(aVert, 1.0); 
// set color 
[7] vCol = vec4(1.0, 0.0, 0.0, 1.0); 
) 














在 @ 行 ， 将 着 色 器 中 使 用 的 GLSL 版 本 设置 为 3.3。 然 后 ， 用 关键 字 in 为 顶点 
着 色 器 定义 一 个 输入 ， 名 为 aVert， 类 型 为 vec3 (三 维 向 量 ) @. FEO HOT, E 
义 两 个 类 型 为 mat4 (4X4 RABIA 的 变量 ， 分 别 对 应 于 模型 视图 和 投影 矩阵 。 这 
些 变量 的 uniform 前 缀 表明 ， 在 执行 顶点 着 色 器 ， 对 一 组 顶点 进行 指定 的 泻 染 调用 
时 ， 它 们 不 会 改变 。 在 @ 行 用 out 定义 了 顶点 着 色 器 的 输出 ， 其 类 型 为 vec4 CAD In] 
fe, 保存 红 、 绿 、 蓝 和 alpha 通道 )， 是 一 个 颜色 变量 。 

接 下 来 是 main0) 函 数 ， 这 是 顶点 着 色 器 程序 开始 的 地 方 。 在 @ 行 计算 出 
gl Position 的 值 ， 方 法 是 利用 传 入 的 uniform 和 矩阵 来 变换 输入 的 aVert。GLSL 变量 
gl Position 用 于 保存 变换 后 的 顶点 。 在 @ 行 ， 将 顶点 着 色 器 的 输出 颜色 设 为 红色 ， 
没有 透明 度 ， 值 为 (1，0，0，1)。 管 线 中 的 下 一 个 着 色 器 用 它 作为 输入 。 


片段 着 色 器 
现在 来 看 一 个 简单 的 片段 着 色 器 : 


© #version 330 core 
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@ in vec4 vCol; 


第 9 章 理解 OpenGL 127 


© out vec4 fragColor; 


void main() { 
// use vertex color 
o fragColor = vCol; 
} 


在 @ 行 设置 着 色 器 的 GLSL 版 本 后 ，@ 行 设置 vCol 作为 片段 着 色 器 的 输入 。 这 
个 变量 vCol 曾 被 设 为 顶点 着 色 器 输出 (回忆 一 下 ， 顶 点 着 色 器 针对 三 维 场景 中 的 
每 个 顶点 执行 ， 而 片段 着 色 器 针对 HR. ENE MRR 执行 
在 光栅 化 期 间 (发 生 在 顶点 着 色 器 和 片段 着 色 器 之 间 ， “OpenGL 将 变换 后 的 顶 
点 转换 为 像素 ， 通 过 在 顶点 颜色 之 间 搬 值 ， 计 算 项 点 之 间 像 素 的 颜色 。 
在 卓 行 ， 定 义 了 输出 颜色 变量 fragColor, fem. 插值 计算 出 的 颜色 被 设置 为 
输出 。 默 认 情 况 下 ， 也 是 在 大 多 数 情况 下 ， 片 段 着 色 器 的 预期 输出 是 屏幕 ， 设 置 的 
颜色 最 终 会 出 现在 屏幕 上 除非 受到 一 些 操 作 的 影响 ， 诸 如 发 生 在 图 形 管线 中 最 后 
阶段 的 深度 测试 )。 

要 让 a 需要 编译 和 链接 ,成 为 硬件 理解 的 指令 。 OpenGL 
提供 了 一 些 方 法 来 做 到 这 一 点 ， 它 报告 详细 的 编译 和 链接 错误 ， 这 有 助 于 开发 着 色 
器 代码 。 
编译 过 程 也 会 为 着 色 器 中 声明 的 变量 产生 一 张 位 置 〈 索 引 ) 表 ， 用 它 可 以 连接 
Python 代码 中 的 变量 和 着 色 器 中 的 变量 。 

































































































































































































































































































































































9.2.4 ”顶点 缓冲 区 
顶点 缓冲 区 是 OpenGL 着 色 器 使 用 的 一 种 重要 机 制 。 现 代 图 形 硬件 和 OpenGL 
则 在 处 理 大 量 的 三 维 几 何 图 形 。 因 此 ，OpenGL 内 建 了 一 些 机 制 ， 帮 助 将 数据 从 程 
序 传输 到 GPU。 程 序 中 绘制 三 维 几 何 图 形 的 典型 计划 将 执行 以 下 操作 : 
1. 为 三 维 几何 图 形 的 每 个 顶点 ， 定 义 坐 标 、 颜 色 和 其 他 属性 的 数组 ; 
创建 一 个 顶点 数组 对 象 (VAO)， 并 绑 定 到 它 ; 
为 每 个 属性 ， 创 建 顶 点 缓冲 区 对 象 (VBO)， 针 对 每 个 顶点 来 定义 ; 
. 绑 定 到 该 VBO， 并 设置 缓冲 区 数据 使 用 预先 定义 的 数组 ; 
. 指定 着 色 器 中 使 用 的 顶点 属性 的 数据 和 位 置 ; 
启用 顶点 的 各 种 属性 ; 
7. TERA o 
用 顶点 来 定义 三 维 几何 图 形 之 后 , 可 以 创建 并 绑 定 到 一 个 顶点 数组 对 象 。VAO 
是 一 种 方便 的 方式 ， 将 几何 图 形 分 组 坐标 、 颜 色 等 多 个 数组 。 然 后 ， 针 对 每 个 顶点 
的 每 个 属性 ， 可 以 创建 一 个 顶点 缓冲 区 对 象 ， 并 将 三 维 数据 设置 给 它 。VBO 将 顶点 
数据 保存 在 GPU 内 存 中 。 现 在 ， 剩 下 的 就 是 连接 缓冲 区 数据 ， 以 便 从 着 色 器 中 访 
问 它 。 通 过 一 些 调 用 ， 它 们 使 用 着 色 器 中 用 到 的 变量 的 位 置 ， 来 实现 这 一 点 。 
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9.2.5 ”纹理 贴图 


9.2.6 


接 下 来 ， 看 看 纹理 贴 
利用 三 维 物体 上 的 二 维 



































图 : 本 章 将 使 
图 片 ， 让 场景 




















的 一 种 





EE 要 计算 机 图 形 技术 。“ 纹 理 贴图 ” 


















































有 逼真 的 感觉 〈 就 像 演 出 的 舞台 背景 )。 


通常 从 一 个 图 像 文件 中 读 取 ， 被 拉 伸 并 有 覆盖 一 个 几何 


[0,1] 映射 到 多 边 形 的 三 维 坐标 上 。 例 如 ， 图 
] GL TRIANGLE STRIP 








个 面 














LE (我 
的 线 来 表示 )。 
在 图 







































































看 到 纹理 的 其 他 角 如 何 映 射 ， 最 终 上 
立方 体 表面 本 身 的 几何 图 形 被 定义 为 一 个 三 角形 带 ， 这 些 顶 点 上 




















看 到 。 
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(0,0) 


纹理 


显示 OpenGL 
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(1,0) 


9-6 纹理 贴图 























纹理 
区 域 ， 将 二 维 坐 标 〈 范 围 为 
































9-6 EAN li 
图 元 来 绘 人 





的 效果 就 是 纹理 














上 上， 再 从 底 到 右上 。 纹 理 是 非常 强大 和 灵活 的 计生 











图 像 覆 盖 在 立方 体 的 一 


























判 立 方 体 各 面 ， 顶 点 的 顺序 由 面 上 


9-6 rp, SHEN) CO. 0) 角 映 射 到 立方 体 表面 的 左下 顶点 。 类 似 地 ， 可 以 
被 “粘贴 ”到 这 个 立方 体 表面 。 


























折 排 列 ， 从 底 到 左 





























机 图 








ELA. Ute 11 章 中 


现在 来 谈 谈 如 何 让 OpenGL 在 屏幕 上 绘制 东西 。 保 存 所 有 OpenGL 状态 信息 


的 实体 叫做 “OpenGL E Fx". E 
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窗口 状 的 区 域 ，OpenGL 

















1 RE 


的 每 次 运行 
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] 以 有 多 个 上 下 文 ， 但 每 个 











的 绘制 在 其 中 进行 ， 每 个 进程 或 应 
线程 在 同一 时 刻 只 能 有 
文 处 理 )。 








要 让 OpenGL 的 输出 











项 目 ， 你 将 使 用 GLFW， 它 是 








个 当前 上 下 文 〈 好 在 ， 窗 口 














[ 具 包 将 负责 大 多 数 的 上 下 









































OpenGL E FX, 在 窗口 中 显示 三 维 图 形 ， H 

















PEER NES 


8 现在 屏幕 的 窗口 中 ， 就 需要 操作 系统 的 帮助 。 对 于 这 些 
FR C 库 ， 可 以 让 你 创建 和 管理 


























(附录 A 介绍 了 这 个 库 的 安装 细节 。) 











F 处 理 

















j 户 的 输入 ， 如 鼠标 点 击 和 按键 。 
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因为 要 用 Python 写 代 码 ， 而 不 是 C 语言 ， 所 以 还 要 使 用 GLEW 的 Python 绑 定 
(glfw.py， 在 本 书 代 码 库 的 common 目录 中 可 以 找到 )， 它 可 以 让 你 用 Python 访问 
GLFW 的 所 有 功能 。 






































9.3 ”所 需 模块 


我 们 将 使 用 PyOpenGL (一 个 流行 的 OpenGL Python HE) KAZ, 并 用 numpy 
数组 来 表示 三 维 坐 标 和 变换 矩阵 。 











9.4 代码 






































让 我 们 用 OpenGL 创建 一 个 简单 的 Python 应 用 程序 。 要 查看 完整 的 项 目 代 码 ， 
请 直接 跳 到 9.5 节 。 





























9.4.1 创建 OpenGL 窗口 

第 一 件 事 就 是 设置 GLFW， 以 便 有 一 个 OpenGL 窗口 显示 泻 染 的 结果 。 我 创 到 

了 一 个 RenderWindow 类 来 做 这 件 事 。 
下 面 是 这 个 类 的 初始 化 代码 ; 


class RenderWindow: 
"""GLFW Rendering window class""" 
def _ init (self): 

















Tar 



































# save current working directory 
cwd = os.getcwd() 


# initialize glfw 
o glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 
e gifw.glfwWindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 
glfw.glfwWindowHint(glfw.GLFW CONTEXT VERSION MINOR, 3) 
glfw.glfwWindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 
glfw.glfwWindowHint(glfw.GLFW OPENGL PROFILE, 
glfw.GLFW OPENGL CORE PROFILE) 


# make a window 
self.width, self.height - 640, 480 
self.aspect = self.width/float(self.height) 
e self.win - glfw.glfwCreateWindow(self.width, self.height, 
b'simpleglfw') 


# make the context current 
o glfw.glfwMakeContextCurrent(self.win) 
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在 @ 行 初始 化 GLFW 库 。 然 后 , 从 @ 行 开始 ,将 OpenGL 版 本 设置 为 OpenGL 3.3 
的 核心 模式 。 在 日 行 ， 创 建 尺 寸 为 640X480 的 、 支 持 OpenGL 的 窗口 。 最 后 , 在 @ 
行 ， 让 它 成 为 当前 上 下 文 ， 然 后 就 可 以 进行 OpenGL 调用 了 。 

接 下 来 ， 进 行 一 些 初始 化 调用 。 

# initialize GL 
glViewport(0, 0, self.width, self.height) 

glEnable(GL_DEPTH_TEST) 

glClearColor(0.5, 0.5, 0.5, 1.0) 

在 @ 行 ， 设 置 视 口 或 屏幕 尺寸 (宽度 和 高 度 )，OpenGL 将 在 其 中 泻 染 三 维 声 
景 。 在 @ 行 ， 用 GL DEPTH TEST 打开 深度 测试 。 在 @ 行 ， 将 泻 染 过 程 中 调用 
LClear(0) 时 的 背景 颜色 设置 为 50% 的 灰色 ，Alpha 设置 为 1.0 (Alpha 是 像素 透明 
度 的 度量 )。 
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9.4.2 ”设置 回调 
下 一 步 , 在 GLFW 窗口 中 为 用 户 接 口 
鼠标 点 击 和 按键 。 


# set window callbacks 
glfw.glfwSetMouseButtonCallback(self.win, self.onMouseButton) 


glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


这 段 代码 分 别 设置 了 鼠标 按钮 、 键 盘 按键 和 窗口 大 小 调整 的 回调 。 每 当 一 个 事 
件 发 生 时 ， 注 册 为 回调 的 函数 就 执行 。 

键盘 回调 

来 看 看 键盘 回调 ， 


def onKeyboard(self, win, key, scancode, action, mods): 
#print ‘keyboard: ', win, key, scancode, action, mods 
LU if action -- glfw.GLFW PRESS: 
# ESC to quit 
if key == glfw.GLFW_KEY_ESCAPE: 
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lim 
bum 





件 注册 一 些 事件 








调 , 这 样 就 可 以 响应 
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e self.exitNow = True 
else: 
# toggle cut 
e self.scene.showCircle - not self.scene.showCircle 























每 次 键盘 事件 发 生 时 ，onKeyboard0 回 调 就 被 调用 。 该 函数 的 参数 被 填充 了 有 
的 信息 ， 如 发 生 事件 的 类 型 (例如 key-up 或 key-down)， 以 及 按 了 哪个 键 。 代 码 
glfw.GLFW PRESS 是 说 只 查找 keydown (或 PRESS) 事件 @。 在 @ 行 ， 如 果 按 下 
ESC 键 ， 就 设置 退出 标志 。 如 果 按 下 其 他 任何 键 ， 翻 转 showCircle 布尔 值 ， 它 将 传 
入 片段 着 色 器 目 。 
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调整 窗口 大 小 事件 
下 面 是 调整 窗口 大 小 事件 的 处 理 : 


def onSize(self, win, width, height): 
#print ‘onsize: ', win, width, height 
self.width = width 
self.height = height 
self.aspect = width/float (height) 
o glViewport(0, 0, self.width, self.height) 


每 次 窗口 大 小 变化 时 , 调用 glViewportO0 重 置 图形 尺 寸 , 确保 三 维 场景 正确 绘制 
在 屏幕 上 @。 同 时 将 尺寸 保存 在 width 和 height 中 ， 改 变 后 的 窗口 的 纵横 比 保存 在 


aspect HF 。 


主 循环 
现在 来 到 程序 的 主 循环 GLFW 不 提供 默认 的 程序 循环 )。 


def run(self): 
# initializer timer 
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o glfw.glfwSetTime(0) 
t = 0.0 
e while not glfw.glfwWindowShouldClose(self.win) and not self.exitNow: 
# update every x seconds 
e currT - glfw.glfwGetTime() 


if currT - t > 0.1: 
# update time 
t = currT 
# clear 
o gliClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 





# build projection matrix 


e pMatrix = glutils.perspective(45.0, self.aspect, 0.1, 100.0) 
© mvMatrix = glutils.lookAt([0.0, 0.0, -2.0], [0.0, 0.0, 0.0], 
[0.0, 1.0, 0.0]) 
# render 
o self.scene.render(pMatrix, mvMatrix) 
# step 
e self.scene.step() 
© glfw.glfwSwapBuffers(self.win) 
# poll for and process events 
© glfw.glfwPollEvents() 


# end 
glfw.glfwTerminate() 


在 主 循环 中 ，glfw.glfwSetTime0 将 GLFW 计时 器 重 置 为 0 @ 行 。 你 将 用 这 个 计 
时 器 定期 重新 绘制 图 形 。while 循环 从 @ 行 开始 ， 只 有 在 窗口 关闭 或 exitNow 设 为 
True 时 退出 。 循 环 退 出 时 ，glfw.glfwTerminate() 被 调用 ， 完 全 关闭 GLFW. 
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在 循环 中 ，glfw.glfwGetTimeO 取 得 当前 计时 器 的 值 目 ， 用 它 来 计算 自 上 次 绘图 
以 来 的 时 间 。 这 里 设置 期 望 的 间隔 〈 在 这 个 例子 中 是 0.1 秒 ， 即 100 毫秒 )， 从 而 可 
以 调整 帧 演 染 的 速度 。 

接着 ， 在 @ 行 ，glClear0 清 除了 深度 和 颜色 缓冲 区 ， 用 设置 的 背景 颜色 替换 它 
们 , 准备 画 下 一 帧 。 在 @ 行 ,用 glutils.py( 下 一 节 将 详细 探讨 ) 中 定义 的 perspective() 
方法 ， 计 算 投影 矩阵 。 这 里 ， 要 求 45 度 视 场 ， 近 / 远 裁 剪 平 面 的 距离 为 0.1/100.0。 
然后 ， 利 用 glutils.py 中 定义 的 lookAt(0 方 法 ， 在 @ 行 设置 模型 视图 矩阵 。 将 眼睛 位 
置 设置 在 (0，0，-2)， 用 一 个 “向 上 ”矢量 (0, 1, 0) 看 向 原点 (0, 0, 0)。 然 后 ， 在 @ 
行 调用 scene 对 象 上 的 render0 方 法 ， 传 入 这 些 和 矩阵 ， 在 @ 行 调用 scene.step(), LAE 
更 新 所 需 的 时 间 步 长 变量 。 在 @ 行 ， 调 用 glftwSwapBuffers()， 交 换 前 后 缓冲 区 ， 从 


而 显示 更 新 的 三 维 图 像 。@ 行 的 glfwPollEventsO) 调 用 检查 所 有 UI 事件 ， 将 控制 返 
回 给 while 循环 。 







































































































































































































































































双 缓 冲 
双 缓 冲 是 平滑 更 新 屏幕 上 图 形 的 泻 染 技术 。 系 统 维护 两 个 缓冲 区 : 一 个 前 缓 
冲 区 和 后 缓冲 区 。 三 维 演 染 先 被 泻 染 到 后 缓冲 区 ， 完 成 时 ， 前 缓冲 区 与 后 缓冲 区 
交换 内 容 。 由 于 缓冲 区 更 新 快速 发 生 ， 这 种 技术 产生 了 更 流畅 的 视觉 效果 ,尤其 
是 在 动画 时 。 双 缓冲 和 链接 到 OS 的 其 他 特征 一 样 ， 是 由 窗口 工具 包 (在 这 个 例 
子 中 是 GLFW ) 提供 的 。 


9.4.3 Scene 类 
现在 来 看 看 Scene 类 ， 它 负责 初始 化 和 绘制 三 维 几何 图 形 。 


























class Scene: 
" OpenGL 3D scene class""" 
# initialization 
def _ init__(self): 
# create shader 
o self.program - glutils.loadShaders(strVS, strFS) 


e glUseProgram(self.program) 
f£ Scene 类 的 构造 函数 中 ， 先 编译 并 加 载 着 色 器 。 要 做 到 这 一 点 ， 我 利用 了 工 
方法 loadShadersO0@@， 它 定义 在 glutils.py 中 ， 为 一 系列 的 OpenGL 调用 提供 了 一 
个 方便 的 封装 ， 这 些 调用 从 字符 串 加 载 着 色 器 ， 编 译 它 们 ， 并 将 它们 链接 成 一 个 
OpenGL 程序 对 象 , 因 为 OpenGL 是 一 个 状态 机 ,所 以 需要 在 @ 行 调用 glUseProgram()， 
设置 代码 使 用 特定 的 “程序 对 象 ”〈 因 为 一 个 项 目 可 能 有 多 个 程序 )。 
现在 ， 将 Python 代码 中 的 变量 与 着 色 器 中 的 变量 连接 起 来 。 


self.pMatrixUniform = glGetUniformLocation(self.program, b'uPMatrix') 
self.mvMatrixUniform - glGetUniformLocation(self.program, b'uMVMatrix') 
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这 段 代 码 利 ) 


# texture 


Self.tex2D = glGetUniformLocation(self.program, b'tex2D') 

















] glGetUniformLocation() 方 法 ,取得 变量 uPMatrix. uMV Matrix 


H 











All tex2D 在 顶点 和 片段 着 色 器 中 的 位 置 。 然 后 这 些 位 置 可 以 用 来 为 着 色 器 变量 


赋值 。 















































定义 三 维 几何 图 形 
先 为 正方 形 定义 三 维 几何 图 形 。 








# define triangle strip vertices 
vertexData = numpy.array( 

[-0.5, -0.5, 0.0, 

0.5, -0.5, 0.0, 

-0.5, 0.5, 0.0, 

0.5, 0.5, 0.0], numpy.float32) 


# set up vertex array object (VAO) 
self.vao = glGenVertexArrays(1) 
gliBindVertexArray(self.vao) 

# vertices 

self.vertexBuffer - glGenBuffers(1) 


giBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


# set buffer data 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 


GL STATIC DRAW) 
# enable vertex array 
glEnableVertexAttribArray (0) 
# set buffer data pointer 


glVertexAttribPointer(0, 3, GL FLOAT, GL FALSE, 0, None) 


# unbind VAO 
glBindVertexArray (0) 





在 @ 行 ,定义 三 角形 
边 长 为 1.0 的 正方 形 。 该 正方 形 的 左下 顶点 坐标 为 (-0.5, -0.5, 0.0)， 下 一 个 顶点 〈 右 





POA 

















带 的 顶点 数组 ， 






































创建 一 个 VBO 来 管理 顶点 数据 的 演 染 。 


设置 缓冲 区 数据 。 















































于 绘制 正方 形 。 设想 一 个 以 原点 为 中 心 ， 

















E 标 为 (0.5, -0.5, 0.0), 依次 类 推 。 坐标 的 顺序 是 GL_TRIANGLE_STRIP 的 顺序 。 


在 @ 行 ， 创建 一 个 VAO。 绑 定 到 该 VAO 后 ， 接 下 来 所 有 调 
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DER ERE. (ket; 
缓冲 区 绑 定 后 ， 第 @ 行 根据 已 定义 的 顶点 ， 


























现在 , 需要 让 着 色 器 能 访问 这 些 数据 了 , 这 在 @ 行 实现 。 GlEnableVertexAttrib 


Array0 被 调 ) 
置 。 在 @ 行 ，glVertexAttribPointerO 设 置 了 顶点 属性 数组 的 位 置 和 数据 格式 。 属 
性 的 下 标 是 0， 组 件 个 数 是 3《〈《 使 用 三 允 
在 @ 行 取消 VAO 绑 定 ， 让 其 他 的 相关 





























j， 下 标 为 0， 因 为 这 是 你 在 顶点 着 色 器 中 设置 的 顶点 数据 变量 的 位 










































































顶点 )， 顶 点 的 数据 类 型 是 GL_FLOAT。 
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它 就 会 一 直 那 样 。 
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周 用 不 会 干扰 它 。 在 OpenGL 中 ， 完 成 工 


RAS we BCE SEER. OpenGL 是 一 个 状态 机 ， 所 以 如 果 留 下 一 个 烂摊子 ， 


00o 











下 面 的 代码 将 图 像 加 载 为 OpenGL AE 


# texture 
self.texId = glutils.loadTexture('star.png') 


返回 的 纹理 ID 稍 后 将 用 于 演 染 。 
下 一 步 ， 更 新 Scene 对 象 中 的 变量 ， 让 正方 形 在 屏幕 上 旋转 : 
# Step 
def step(self): 
# increment angle 
self.t = (self.t + 1) % 360 
# set shader angle in radians 


glUniformif(glGetUniformLocation(self.program, 'uTheta'), 
math.radians(self.t)) 


EOT, SEARRE t， 并 利用 取 模 操作 符 (%)， 保 持 该 值 在 [0，360] 的 范 
围 内 。 然 后 ， 在 @ 行 利用 glUniform1f0 方 法 ， 在 着 色 器 程序 中 设置 该 值 。 像 以 前 一 
FÉ. HH glGetUniformLocation0 来 获得 着 色 器 中 的 uTheta 角 变量 的 位 置 ， 而 Python 
的 math.radians0 方 法 将 度 转换 为 弧度 。 
现在 来 看 看 主要 的 泻 染 代 码 : 

# render 
def render(self, pMatrix, mvMatrix): 


# use shader 
glUseProgram(self.program) 








ro 












































































































































# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL FALSE, pMatrix) 


# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL FALSE, mvMatrix) 


# show circle? 
glUniform1i(glGetUniformLocation(self.program, b'showCircle'), 
self.showCircle) 


# enable texture 

glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texId) 
glUniform1i(self.tex2D, 0) 


# bind VAO 
glBindVertexArray (self .vao) 

# draw 

gliDrawArrays(GL TRIANGLE STRIP, 0, 4) 
# unbind VAO 

glBindVertexArray (0) 


在 @ 行 ,设置 演 染 使 用 着 色 器 程序 ,然后 , 从 @ 行 开始 ,利用 glUniformMatrix4fv() 
方法 ， 在 着 色 器 中 设置 计算 好 的 投影 和 模型 视图 和 矩阵。 在 @ 行 用 glUniformliQ, 3 
置 片 段 着 色 器 中 showCircle 变量 的 当前 值 。OpenGL 有 多 纹理 单元 的 概念 ， 
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gLActiveTexture0@ 激 活 纹 理 单元 0〈 默 认 值 )。 在 























@ 行 ， 绑 定 前 面 生成 的 纹理 ID, 


激活 它 ， 准 备 泻 染 。 在 @ 行 ， 片 段 着 色 器 中 的 sampler2D 变量 设 为 纹理 单元 0。 在 
































@ 行 ， 绑 定 到 先前 创建 的 VAO。 现 在 你 看 到 了 使 
不 需要 重复 一 大 堆 顶 点 缓冲 相关 的 调用 。 在 @ 行 ， 
的 顶点 缓冲 区 。 图 元 类 型 是 一 个 三 角形 带 ， 有 四 
VAO， 这 是 恨 好 的 编码 习惯 。 


定义 GLSL 着 色 器 


现在 让 我 们 看 看 项 目 中 最 精彩 的 部 分 : GLSL 


#version 330 core 
















































































© layout(location = 0) in vec3 aVert; 


@ uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
uniform float uTheta; 


© out vec2 vTexCoord; 


void main() { 
// rotational transform 
o mat4 rot - mat4( 
vec4(cos(uTheta), sin(uTheta), 0.0, 0 





] VAO 的 好 处 了 : 实际 绘制 之 前 ， 
glDrawArrays0 被 调用 ， 演 染 绑 定 
个 顶点 要 演 染 。 在 @ 行 取消 绑 定 

















着 色 器 。 这 是 顶点 着 色 器 : 
































.0 


); 
vec4(-sin(uTheta), cos(uTheta), 0.0, 0.0), 


vec4(0.0, 0.0, 1.0, 0.0), 
vec4(0.0, 0.0, 0.0, 1.0) 
) ; 


// transform vertex 


e gl Position - uPMatrix * uMVMatrix * rot * vec4(aVert, 1.0); 
// set texture coordinate 
© vTexCoord = aVert.xy + vec2(0.5, 0.5); 
} 





在 @ 行 ， 用 layout 关键 字 明 确 设置 顶点 的 位 置 属性 aVert: 在 这 个 例子 中 设置 为 
0。 从 @ 行 开始 ， 声 明 一 些 uniform 变量 : 投影 和 模型 视图 和 矩阵 和 旋转 角度 。 这 些 将 


























在 Python 代码 中 设置 。 在 @ 行 ， 设 置 一 个 二 维 矢 量 VTexCoord， 作 为 这 个 着 色 器 的 




















































































































输出 。 它 将 作为 片段 着 色 器 的 输入 。 在 着 色 器 的 main0) 方 法 中 ， 在 @ 行 设立 旋转 矩 
阵 ， 它 围绕 z 轴 旋 转 给 定 的 角度 。 在 @ 行 ， 利 用 投影 、 模 型 视图 和 旋转 矩阵 级 联 来 
计算 gl Position。 在 @ 行 ， 设 置 一 个 二 维 向 量 作为 纹理 坐标 。 你 可 能 还 记得 ， 你 定 


























义 了 三 角形 带 ， 表 示 以 原点 为 中 心 、 边 长 为 1.0 的 正方 形 。 因 为 纹理 坐标 的 范围 是 











[0,1]， 所 以 可 以 通过 在 x EM y 值 上 增加 (0.5, 0.5 




















)， 从 顶点 坐标 来 生成 它们 。 这 也 





























展示 了 着 色 器 的 计算 的 能 力 和 巨大 的 灵活 性 。 纹 到 

















坐标 和 其 他 变量 不 是 神圣 不 可 侵 











犯 的， 你 可 以 将 它们 设置 为 任何 东西 。 
现在 ， 来 看 看 片段 着 色 器 ; 
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#version 330 core 


© in vec4 vCol; 
in vec2 vTexCoord; 


uniform sampler2D tex2D; 
uniform bool showCircle; 


oc 


© 


out vec4 fragColor; 


void main() { 
if (showCircle) { 
// discard fragment outside circle 


e if (distance(vTexCoord, vec2(0.5, 0.5)) > 0.5) { 
discard; 

} 
else { 

© fragColor = texture(tex2D, vTexCoord); 
} 

} 

else { 

[7] fragColor - texture(tex2D, vTexCoord); 
} 

} 


从 @ 行 开始 ， 定 义 了 片段 着 色 器 的 输入 : 就 是 设置 为 顶点 着 色 器 的 输出 变量 的 
那些 颜色 和 纹理 坐标 变量 。 回 想 一 下 ， 片 段 着 色 器 基于 每 个 像素 操作 ， 因 此 ， 对 这 
些 变 量 设 置 的 值 是 针对 当前 像素 的 值 ， 在 整个 多 边 形 中 内 插 。 在 @ 行 声明 了 
sampler2D 变量 ， 它 被 连接 到 一 个 特定 的 纹理 单元 ， 用 于 查找 纹理 值 。 在 目 行 ， 声 
明了 布尔 型 uniform 标志 showCircle， 这 是 从 Python 代码 中 设置 的 ， 在 @ 行 ， 声 明 
了 fragColor， 作 为 片段 着 色 器 的 输出 。 默 认 情况 下 ， 会 显示 在 屏幕 上 【经 过 最 后 的 
帧 缓冲 区 操作 ， 如 深度 测试 和 混合 )。 

如 果 没 有 设置 showCircle 标志 ， 在 @ 行 ， 使 用 GLSL 的 texture0 方 法 来 查找 纹 
里 颜色 值 ， 利 用 了 纹理 坐标 和 采样 。 实 际 上 ， 你 只 是 用 星 形 图 像 来 设置 三 角形 带 的 
纹理 。 但 如 果 showCircle 标志 为 真 ， 在 @ 行 ， 用 GLSL 的 内 置 方法 distance， 来 检 
查 当前 像素 离 多 边 形 的 中 心 有 多 远 。 出 于 这 个 目的 ， 它 使 用 (内 插 的 ) 纹理 坐标 ， 
这 是 由 顶点 着 色 器 传 入 的 。 如 果 该 距离 大 于 某 一 阔 值 (在 本 例 中 是 0.53)， 就 调用 
GLSL 的 discard 方法 ， 于 弃 当前 像素 。 如 果 该 距离 小 于 阔 值 ， 就 在 @ 行 设置 来 自 纹 
蛙 的 适当 颜色 。 事 实 上 ， 这 样 做 就 忽略 了 以 正方 形 的 中 点 为 中 心 、 半 径 为 0.5 的 圆 
之 外 的 像素 ， 从 而 在 showCircle 设置 时 ， 切 割 该 多 边 形 ， 放 入 圆 中 。 


















































































































































































































































































































































































































































9.5 ”完整 代码 


这 个 简单 的 OpenGL 应 用 程序 的 完整 代码 分 为 两 个 文件 : simpleglfw.py， 包 含 
下 面 展 示 的 代码 , 并 可 以 在 https://github.com/electronut/pp/tree/master/simplegl/4X $1] ; 
glutils.py， 包 括 一 些 辅助 方法 ， 让 生活 更 轻松 ， 可 以 在 common 目录 中 找到 。 
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import OpenGL 
from OpenGL.GL import * 


import numpy, math, sys, os 
import glutils 


import glfw 


strvg = """ 
#version 330 core 


layout(location = 0) in vec3 aVert; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
uniform float uTheta; 


out vec2 vTexCoord; 


void main() { 
// rotational transform 
mat4 rot = mat4( 
vec4(cos(uTheta), sin(uTheta), 0.0, 0.0), 
vec4(-sin(uTheta), cos(uTheta), 0.0, 0.0), 
vec4(0.0, 0.0, 1.0, 0.0), 
vec4(0.0, 0.0, 0.0, 1.0) 
); 
// transform vertex 
gl Position - uPMatrix * uMVMatrix * rot * vec4(aVert, 1.0); 
// set texture coordinate 
vTexCoord = aVert.xy + vec2(0.5, 0.5); 
} 


strFS = """ 
#version 330 core 


in vec2 vTexCoord; 


uniform sampler2D tex2D; 
uniform bool showCircle; 


out vec4 fragColor; 


void main() { 
if (showCircle) { 
// discard fragment outside circle 
if (distance(vTexCoord, vec2(0.5, 0.5)) > 0.5) { 


discard; 
} 
else { 
fragColor = texture(tex2D, vTexCoord) ; 
} 
} 
else { 
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fragColor = texture(tex2D, vTexCoord) ; 


} 


class Scene: 
""" OpenGL SD scene class""" 
# initialization 
def _ init__(self): 
# create shader 
self.program = glutils.loadShaders(strVS, strFS) 


glUseProgram(self.program) 

self .pMatrixUniform = glGetUniformLocation(self.program, b'uPMatrix') 
self.mvMatrixUniform = glGetUniformLocation(self.program, b'uMVMatrix' ) 
# texture 

self.tex2D = glGetUniformLocation(self.program, b'tex2D') 


# define triange strip vertices 
vertexData = numpy.array ( 

[-0.5, -0.5, 0.0, 

0.5, -0.5, 0.0, 

«0.5, 0.5, 0.0, 

0.5, 0.5, 0.0], numpy.float32) 


# set up vertex array object (VAO) 

self.vao = glGenVertexArrays(1) 

giBindVertexArray (self.vao) 

# vertices 

self.vertexBuffer = glGenBuffers(1) 

g1BindBuffer(GL_ARRAY_BUFFER, self.vertexBuffer) 

# set buffer data 

glBufferData(GL_ARRAY_BUFFER, 4*len(vertexData), vertexData, 
GL_STATIC_DRAW) 

# enable vertex array 

glEnableVertexAttribArray (0) 

# set buffer data pointer 

glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 0, None) 

# unbind VAO 

glBindVertexArray (0) 


# time 

self.t = 0 

# texture 

self.texId = glutils.loadTexture('star.png') 


# show circle? 
self.showCircle = False 


# step 
def step(self): 
# increment angle 
self.t = (self.t + 1) % 360 
# set shader angle in radians 
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glUniformif(glGetUniformLocation(self.program, ‘uTheta'), 
math.radians(self.t) ) 


# render 

def render(self, pMatrix, mvMatrix): 
# use shader 
glUseProgram(self.program) 


# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL FALSE, pMatrix) 


# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL FALSE, mvMatrix) 


# show circle? 
glUniform1i(glGetUniformLocation(self.program, b'showCircle'), 
self.showCircle) 


# enable texture 

glActiveTexture(GL TEXTUREO) 
giBindTexture(GL TEXTURE 2D, self.texId) 
glUniform1i(self.tex2D, 0) 


# bind VAO 
glBindVertexArray(self.vao) 

# draw 
glDrawArrays(GL_TRIANGLE_STRIP, 0, 4) 
# unbind VAO 

glBindVertexArray (0) 


class RenderWindow: 
"""GLFW Rendering window class""" 
def | init__(self): 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw - this changes cwd 
glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 

glfw.glfwWindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 

gifw.glfwWindowHint (glfw.GLFW CONTEXT VERSION MINOR, 3) 

glifw.glfwWindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 

gifw.glfwWindowHint (glfw.GLFW OPENGL PROFILE, 
glfw.GLFW OPENGL CORE PROFILE) 

# make a window 

self.width, self.height = 640, 480 

self.aspect = self.width/float(self.height) 

self.win = glfw.glfwCreateWindow(self.width, self.height, 

b'simpleglfw' ) 
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def 


def 


def 


def 


# make context current 
glfw.glfwMakeContextCurrent(self.win) 


# initialize GL 

glViewport(0, 0, self.width, self.height) 
glEnable(GL_DEPTH_TEST) 

glClearColor(0.5, 0.5, 0.5, 1.0) 


# set window callbacks 
glfw.glfwSetMouseButtonCallback(self.win, self .onMouseButton) 
glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


# create 3D 
self.scene = Scene() 


# exit flag 
self.exitNow = False 


onMouseButton(self, win, button, action, mods): 
#print ‘mouse button: ', win, button, action, mods 
pass 


onKeyboard(self, win, key, scancode, action, mods): 
#print ‘keyboard: ', win, key, scancode, action, mods 
if action == glfw.GLFW_PRESS: 
# ESC to quit 
if key == glfw.GLFW_KEY_ESCAPE: 
self.exitNow = True 
else: 
# toggle cut 
self.scene.showCircle = not self.scene.showCircle 


onSize(self, win, width, height): 

#print ‘onsize: ', win, width, height 
self.width = width 

self .height = height 

self.aspect = width/float (height) 
glViewport(0, 0, self.width, self.height) 


run(self): 
# initializer timer 
glfw.glfwSetTime(0) 
t = 0.0 
while not glfw.glfwWindowShouldClose(self.win) and not self.exitNow: 
# update every x seconds 
currT = glfw.glfwGetTime() 
if currT - t > 0.1: 
# update time 
t = currT 
# clear 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
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# build projection matrix 
pMatrix = glutils.perspective(45.0, self.aspect, 0.1, 100.0) 


mvMatrix = glutils.lookAt([0.0, 0.0, -2.0], [0.0, 0.0, 0.0], 
0.0 


[ , 1.0, 0.0]) 
# render 
self.scene.render(pMatrix, mvMatrix) 
# step 


self .scene.step() 


glfw.glfwSwapBuffers(self.win) 
# poll for and process events 
glfw.glfwPollEvents() 


# end 
glfw.glfwTerminate() 


def step(self): 
# clear 
glClear(GL_COLOR_BUFFER_BIT | GL DEPTH BUFFER BIT) 





# build projection matrix 
pMatrix = glutils.perspective(45.0, self.aspect, 0.1, 100.0) 


mvMatrix = glutils.lookAt([0.0, 0.0, -2.0], [0.0, 0.0, 0.0], 
0.0 


[ » 1.0, 0.0]) 
# render 
self.scene.render(pMatrix, mvMatrix) 
# step 


self .scene.step() 


glfw.SwapBuf fers (self .win) 
# poll for and process events 
glfw.PollEvents() 


# main() function 
def main(): 
print("Starting simpleglfw. " 
"Press any key to toggle cut. Press ESC to quit.") 
rw - RenderWindow() 





rw.run() 

# call main 

if name == ' qain ' 
main() 


9.6 ”运行 OpenGL 应 用 程序 


下 面 是 该 项 目的 运行 示例 : 
$python simpleglfw.py 


输出 如 图 9-1 所 示 。 
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现在 ， 让 我 们 快速 浏览 一 下 在 glutils.pie 中 定义 的 一 些 工具 
图 像 ， 作 为 OpenGL 纹 


载 





def loadTexture(filename): 
"""load OpenGL 2D texture from given image file""" 


9000060 


glTexParameterf(GL TEXTURE 2D, 
glTexParameterf(GL TEXTURE 2D, 
glTexParameterf(GL TEXTURE 2D, 
glTexImage2D(GL TEXTURE 2D, 0, 


o 











H . 
EER 








img = Image.open(filename) 
imgData = numpy.array(list(img.getdata()), np.int8) 
texture = glGenTextures(1) 
glBindTexture(GL_TEXTURE_2D, texture) 
glPixelStorei(GL_UNPACK_ALIGNMENT, 1) 
glTexParameterf(GL TEXTURE 2D, 


GL 











方法 。 这 个 方法 加 


TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE) 





TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE) 





TEXTURE_MAG_FILTER, GL_LINEAR) 





TEXTURE_MIN_FILTER, GL_LINEAR) 





G 
G 
G 
G 
I 


RGBA, img.size[0], img.size[1], 


0, GL RGBA, GL UNSIGNED BYTE, imgData) 





return texture 


fEO 1]. loadTextureO Ff 2X 
文件 。 然 后 在 @ 行 ， 获 取 Image WRN AH 
创建 一 个 OpenGL 纹理 





缘 的 纹理 
惯例 是 使 


型 , 在 拉 伸 或 1 












































] Python 图 


对 象 ， 这 是 在 OpenGL ! 
在 @ 行 ， 执 行 现在 你 比较 熟悉 的 绑 定 texture 对 象 ， 这 样 所 有 后 来 纹理 
置 都 应 用 了 
被 硬件 认为 是 1 字 节 (或 8 位 ) 的 数据 。 从 @ 行 开始 ， 


该 对 象 。 在 @ 行 ， 将 数据 的 拆 包 对 齐 设置 为 1， 这 意味 着 该 











。 在 这 个 例子 







































































在 @ 行 ， 设 置 绑 定 纹理 














中 





使 用 了 。 


9.7 


小 结 


恭喜 你 完成 了 使 


程 迷 人 世界 的 旅程 。 


9.8 ”实验 


下 面 有 一 些 1 
1. 





轴 


第 二 ， 



























































这 个 项 目 











多 改 这 个 项 目 
中 ， 顶 点 着 色 器 
(1，1，0) 旋转 吗 ? 可 以 月 


的 














的 想 





























在 Python 代码 计算 


法 都 试 一 下 。 


H PIE} 











图 








< 缩 纹理 来 覆盖 多 边 形 时 采 上 
图 像 数 据 。 此 时 


Python 和 OpenGL 的 第 一 个 程序 。 你 已 踏 上 进入 三 维 


VA 








的 边缘 截取 纹理 颜色 (指定 纹理 坐 
字母 S$ 和 T 表示 轴 ， 而 不 是 x 和 y)。 在 @ 行 和 下 一 行 ， 指 定 插 








像 库 (PIL) 的 Image 模块 读 取 图 像 
E, HUN 8 位 的 numpy 数组 ， 在 @ 行 ， 
利用 纹理 做 任何 事 的 先决 条 件 。 
相关 的 设 
图 像 数 据 
告诉 OpenGL 如 何 处理 边 
示 时 ， 
值 类 








































































































日 。 在 这 个 例子 





围绕 z 轴 

















方式 实现 : 第 一 ， 修 改 着 色 器 : 





» 指定 为 “线性 滤波 ”。 
像 数据 传送 到 显存 ， 纹 理 准备 好 



































? 图 




















图 形 编 























(0，0，1) 旋转 正方 形 。 你 能 让 它 绕 
的 旋转 矩阵 ， 




















这 个 矩阵 ， 将 它 作 为 一 个 uniform 传 入 着 色 器 。 两 种 方 
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2. 这 个 项 目 中 ， 纹 理 坐 标 在 顶点 着 色 器 内 产生 ， 并 传 入 片段 着 色 器 。 这 是 一 
种 方法 ， 它 有 效 只 是 因为 三 角形 带 的 顶点 选择 了 方便 的 值 。 请 将 纹理 坐标 作为 单独 
的 属性 传 入 顶点 着 色 器 ， 类 似 于 顶点 传 入 的 方式 。 现 在 ， 你 能 让 星 形 纹理 平 铺 三 角 
形 带 吗 ? 不 是 显示 一 颗 星 ， 而 是 在 正方 形 上 生成 4X4 的 星星 网 格 〈 提 示 : 使 用 大 
T 1.0 的 纹理 坐标 ， 并 将 glTexParameterf0 中 的 GL. TEXTURE. WRAP. S/T 参数 设 
置 为 GL REPEAT). 

3. 只 修改 片段 着 色 器 ， 能 让 你 的 正方 形 如 图 9-7 Brox Chee: 使 用 GLSL 的 
sin(0) 函 数 ) ? 





















































9-7 使 用 片段 着 色 器 来 画 出 同心 贺 
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#10 « 


粒子 系统 















































在 计算 机 图 形 世 界 中 , 粒子 系统 是 用 许多 小 图 元 (如 点 、 线 、 
三 角形 和 多 边 形 ) 来 表示 的 物体 ， 如 烟雾 、 火 焰 ， 甚 至 头发 ， 没 
有 明确 的 几何 形状 ， 因 此 很 难 用 标准 技术 来 建 模 。 

例如 , 如 何在 计算 机 上 制造 一 次 爆炸 效果 ? 设想 爆炸 从 空间 
中 的 一 个 点 开始 , 然后 向 外 扩张 ,作为 一 个 快速 扩大 的 、 复 杂 的 
维 实体 ， 随 时间 而 改变 形状 和 颜色 。 不 夸张 地 说 ， 尝 试 建立 数 
学 模型 就 令 人 望 而 生 上 其 。 
但 现在 设想 一 下 ， 爆 炸 包含 一 群 细 小 的 粒子 ， 每 个 粒子 有 关联 的 位 置 和 颜色 。 
爆炸 开始 时 ， 粒 子 在 空间 中 的 一 个 点 上 聚 成 一 图 。 随 着 时 间 的 推移 ， 它 们 根据 一 定 
的 数学 规则 向 外 移动 ， 并 改变 颜色 ,让 你 定期 绘制 所 有 粒子 ， 从 而 生成 爆炸 的 动画 。 
利用 好 的 数学 模型 、 大 量 粒子 ， 以 及 透明 度 和 公告 板 Cbillboarding) 这样 的 泻 染 技 
术 ， 可 以 创建 逼真 的 效果 ， 如 图 10-1 所 示 。 

本 项 目 会 制定 粒子 运动 的 数学 模型 ， 将 它 表 示 为 时 间 的 函数 ， 并 利用 图 形 处 理 
单元 (GPU) 的 着 色 器 进行 计算 。 然 后 ， 会 设计 一 种 演 染 方案 ， 利 用 一 种 名 为 公告 
板 的 技术 ， 它 让 二 维 图 像 一 直面 向 观众 ， 从 而 使 二 维 图 像 看 起 来 像 是 三 维 的 ， 用 一 
种 令 人 信服 的 方式 来 绘制 这 些 粒子 。 还 会 用 OpenGL 着 色 器 让 粒子 旋转 ， 并 生成 去 
画 场 景 。 你 可 以 通过 按键 来 打开 或 关闭 各 种 效果 ， 进 行 比 较 。 
































































































































































































































RR 

















































































































































































































































































































eoo Particle System 





10-1 已 完成 项 目的 运行 示例 


数学 模型 将 设置 每 个 粒子 的 初始 位 置 和 速度 ， 并 决定 粒子 如 何 随时 间 运 动 。 你 























可 以 让 每 个 纹理 的 黑色 区 域 透明 ， 利 用 正方 形 图 像 创 建 火花 ， 保 持 每 个 火花 面向 观 
众 ， 使 它们 看 起 来 有 立体 感 。 你 会 生成 粒子 的 动画 ， 定 期 更 新 它们 的 位 置 ， 其 亮度 
随 着 时 间 的 推移 逐渐 减弱 。 
下 面 是 将 要 探索 的 一 些 概念 : 

e 制定 喷泉 粒子 系统 的 数学 模型 ; 

。 利用 GPU 着 色 器 计算 ; 
。 利用 纹理 和 公告 板 模拟 复杂 的 三 维 对 象 ; 

e 利用 OpenGL 演 染 功能 ， 如 混合 、 深 度 遮 掩 和 Alpha 通道 ， 绘 制 半 透 明 物体 ; 
。 利用 相机 模型 绘制 三 维 透视 图 。 































































































10.1 工作 原理 
要 创建 动画 ， 就 需要 一 个 数学 模型 。 从 一 个 固定 点 开始 ， 移 动 一 些 粒子 ， 随 
时 间 推 移 沿 抛物 线 轨 迹 运 动 ， 形 成 火花 喷泉 ， 如 图 10-2 MR. EMER ALT 
系统 。 
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10-2 5 个 示例 火花 在 喷泉 粒子 系统 中 的 轨迹 


我 们 的 粒子 系统 应 具有 以 下 特性 : 
。 粒子 应 该 从 固定 点 的 出 现 ， 它 们 的 运动 轨迹 
e 粒子 应 该 能 相对 于 顺 泉 的 垂直 轴 (z 轴 或 高 度 )， 运 动 预定 距离 ; 

。 较 接近 喷 果 垂直 轴 中 心 的 粒子 ， 应 该 比 离 中 心 较 远 的 粒子 初速 度 更 大 ; 
。 BOA BAIN SCR, BPA DE AB R, 
。 粒子 的 亮度 应 该 随时 间 推 移 逐 渐 淡 出 。 














Wize Ws 


































































































10.1.1 为 粒子 运动 建 模 
假设 粒子 系统 包含 N 个 粒子 。 第 


"E 
FB Veteran 


i 个 粒子 的 运动 方程 如 下 : 























这 里 


, P xe 


是 在 时 间 + 的 位 置 。Po 为 粒子 的 初始 位 置 ，Wo 是 粒子 的 初始 速度 ，a 











是 加 速度 。 可 
这 些 参数 
—9. 8 ) š 


10.1.2 设置 最 大 范围 


这 是 地 球 在 z 轴 


以 认为 a 是 系统 中 的 重力 加 速度 ， 让 粒子 沿 向 下 
都 是 三 维 向 量 ， 可 以 表示 为 三 维 坐标 。 例 


























的 弧 线 运动 。 
如 ,使 用 加 速度 值 是 C0, 0, 
























































要 让 喷 凡 看 起 来 远 真 ， 粒 子 应 相对 于 加 
让 每 个 粒子 的 初始 速度 在 一 定 范 
轴 





要 设置 一 个 最 
形成 喷泉 的 样 





如 














大 范围 ， 








(垂直 ) 方向 的 重力 加 速度 ， 和 


锥 体 的 z 5 











a 
EP 


是 米 每 平方 秒 。 





， 以 不 同 的 角度 飞 出 。 但 也 











围 内 , 让 这 些 粒子 呈 漏 斗 状 ， 
































子 。 为 了 实现 这 个 目标 ， 将 速度 与 垂直 


的 最 大 角度 确定 为 20 B, 














图 10-3 所 示 。 
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10-3 限制 每 个 粒子 的 初始 速度 范围 。 每 个 粒子 分 配 的 速度 在 阴影 圆 内 











在 图 10-3 中 , 方位 角 8 是 速度 向 量 与 x 轴 的 夹 角 。 倾斜 角 0 是 速度 向 量 与 z 轴 








的 夹 角 。 倾 斜 角 的 选择 范围 让 速度 向 量 处 于 图 


























速度 方向 应 该 从 大 圆圈 包围 的 半球 部 分 ! 




















浅 灰色 阴影 区 域内 。 
随机 选择 。 这 些 方向 的 端点 处 于 一 个 











单位 半径 的 球面 上 ， 这 样 就 可 以 用 球 坐 标 系 来 计算 它们 。 此 外 ， 我 们 希望 速度 值 随 
着 与 轴 的 夹 角 增 大 而 减 小 。 考 虑 到 这 一 点 ， 粒 子 的 初始 速度 如 下 : 




















Vi =(1-a’ Vv 





XB, a 是 粒子 的 倾斜 角 与 最 大 角度 〈 这 个 例子 中 是 20 度 ) 之 比 。 因 此 ， 随 着 
这 个 比值 逐渐 变 为 1.0， 速 度 《〈 二 次 地 ) 下 降 。 





面 这 样 : 



































速度 Y 是 单位 球面 上 一 个 点 ， 像 下 


V = (cos(0)sin(®),sin e(0)sin(®), cos(®)) 


在 [0，20] 度 范围 内 随机 选择 一 个 倾斜 角 ， 








方位 角 : 











在 [0，360] 度 范围 内 随机 选择 一 个 





0 = random([0, 20]), ® = random([0,360]) 

















这 个 方程 让 粒子 指向 图 10-3 中 圆圈 区 域内 的 一 个 随机 点 (注意 , 在 这 个 程序 中 ， 








所 有 角度 计算 需要 用 弧度 ， 不 是 度 )。 
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10.1.3 














我 们 也 希望 确保 粒子 不 在 同一 时 间 开 始 (原因 请 参阅 10.10 节 )。 要 做 到 这 一 点 ， 
为 每 个 粒子 计算 一 个 时 间 延 迟 ， 稍 后 在 计算 粒子 位 置 时 使 用 。 第 守 个 粒子 的 延迟 计 
算 如 下 : 














tag = 0.05i 
这 些 方程 中 随意 采用 的 数值 常数 是 怎么 来 的 ? 例如 ， 为 什么 用 0.05 作为 延迟 时 


间 ， 用 20 度 作为 最 大 角度 ? 答案 是 实验 。 重 要 的 是 创建 一 个 基本 模型 ， 然 后 调整 这 
些 常数 , 以 获得 最 佳 视觉 效果 。 改变 程序 中 的 这 些 参数 , 看 看 不 同 的 值 如 何 影响 结果 。 


























— 

















泻 染 粒子 





演 染 粒子 的 一 种 简单 方式 ， 就 是 将 它们 绘制 为 点 。OpenGL 有 GL, POINTS 图 
元 ， 本 质 上 是 屏幕 上 的 一 个 点 ; 你 可 以 控制 点 的 像素 大 小 和 颜色 。 但 我 们 希望 粒子 
看 起 来 像 小 火花 ， 并 且 随 着 喷发 而 旋转 。 
从 头 开始 绘制 火花 太 复 杂 了 ， 所 以 需要 一 张 火 花 的 照片 ， 作 为 纹理 粘贴 到 一 个 
和 矩形 (也 称 为 “四 边 形 ”)。 喷 泉 中 的 每 个 粒子 都 被 绘制 成 火花 的 三 角形 纹理 图 像 。 
但 是 ， 这 提出 两 个 问题 。 首 先 ， 不 希望 正方 形 火 花 ， 因 为 那 显得 很 假 。 其 次 ， 如 果 
从 其 他 角度 看 喷泉 ， 四 边 形 的 方向 会 不 对 。 






































































































































10.1.4 利用 OpenGL 混合 来 创建 更 允 真 火花 














为 了 创造 更 到 真 的 火花 ,我 们 利用 OpenGL 的 混合 (blending )。 结 合 传 入 的 
片段 (片段 着 色 器 执行 之 后 ) 和 帧 缓冲 区 中 己 有 的 内 容 。 这 项 操作 通常 涉及 Alpha 
























































例如 , 假设 在 屏幕 上 绘制 两 个 多 边 形 , 并 想 将 它们 混合 在 一 起 。 你 可 以 用 alpha 
混合 的 技巧 ， 它 的 工作 原理 是 将 两 个 透明 片 重 亚 起 来 。alpha 通道 表示 像素 的 不 透 
明度 ， 它 是 透明 程度 的 量度 。 除 了 表示 一 个 像素 颜色 的 红 、 绿 、 蓝 分 量 之 外 ， 还 
可 以 存储 一 个 alpha 值 ， 得 到 的 颜色 方案 称 为 RGBA。 对 于 32 位 的 RGBA 颜色 方 
案 ，alpha 值 的 范围 是 [0,255]，0 是 完全 透明 ，255 是 完全 不 透明 。alpha 通道 本 身 
不 做 任何 事情 。 只 有 用 alpha 值 来 改变 像素 的 最 终 RGB 值 时 ， 才 会 创建 各 种 透明 
效果 。 
OpenGL 提供 了 几 种 方法 来 定制 混合 方程 。 对 于 喷 果 粒子 ， 我 们 将 使 用 图 10-4 
所 示 的 纹理 ， 但 要 让 纹理 的 黑色 区 域 消失 ， 这 样 就 会 只 看 到 火花 。 
启用 OpenGL 的 混合 ， 用 片段 的 alpha 值 乘 以 纹理 的 颜色 ， 可 以 让 黑色 区 域 消 
失 。 对 于 黑色 区 域 ，RGB 颜色 值 是 (0，0，0), 如 FEV alpha 值 ， 将 得 到 0。 因 
此 ， 经 过 混合 ， 黑 色 区 域 在 最 终 图 像 中 的 不 透明 度 是 0， 你 看 到 的 只 是 背景 颜色 ， 
实际 上 去 掉 了 火花 纹理 的 黑色 区 域 (alpha 值 在 片段 着 色 器 中 设置 ， 在 10.3.5 节 中 
有 介绍 )。 
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RGB = (0, 0, 0) 


RGB = (255, 255, 255) 


图 10-4 火花 纹理 ， 标 有 RGB 值 (0，0，0 ) ABE, (255, 255, 255) 为 白色 





注意 除了 在 着 色 器 中 设置 alpha 值 ， 也 可 以 利用 纹理 图 像 中 的 alpha 通道 ， 为 黑 
色 和 白色 区 域 设 定 不 同 的 alpha 值 , 从 而 控制 透明 度 。 在 着 色 器 中 使 用 alpha 值 ， 
创建 带 有 黑色 背景 的 纹理 ， 再 让 所 有 黑色 区 域 透 明 ， 这 更 简单 ， 优 于 在 纹理 中 
使 用 alpha 通道 ， 让 特定 区 域 有 不 同 的 透明 度 值 。 





10.1.5 ”使 用 公告 板 

















对 于 第 二 个 问题 (如 果 从 其 他 角度 看 喷泉 ， 四 边 形 的 方向 不 对 )， 我 们 将 使 用 
公告 板 。 我 们 不 是 绘制 复杂 的 三 维 物 体 ， 而 是 放置 一 个 二 维 的 图 片 ， 让 你 总 是 看 到 


ab EL EH 




















人 Fi 





















































其 正面 《面向 观看 的 方向 )， 作 为 一 种 公告 板 。 例 如 ， 在 开发 三 维 游戏 时 ， 背 景 是 





















































近 ， 假 的 “图 片 树 ”看 起 来 就 很 盟 真 。 
现在 来 看 看 放置 多 边 形 背后 的 数学 ， 以 便 让 它 总 是 面向 观看 的 方向 。 图 
展示 了 如 何 将 一 个 纹理 四 边 形变 成 一 个 公告 板 。 
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(近似 向 上 向 量 ) 















































U 





真正 向 上 向 量 


uxn 





(多 边 形 法 向 /观看 方向 相反 ) 


n(-v) 


10-5 公告 板 
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树木 景观 ， 可 以 用 一 个 带 纹理 的 多 边 形 公告 板 来 蔡 代 树木 景观 。 只 要 玩家 靠 得 不 太 


10-5 











THREE AS F Ee Dr AR VER 
































量 是 Nn, 


准 四 边 








代表 四 边 形 的 法 线 向 量 。 法 线 向 各 











定 的 法 线 向 量 方向 ， 就 是 四 边 
V n jE 





v, Br 





Jo 在 这 个 例子 中 ， 
攻 ， 需 要 三 个 正 交 向 量 ， 创 建 一 个 小 坐标 系统 。 我 们 感 兴趣 的 第 一 个 向 









































EIE 


























这 意味 着 
以 向 上 向 量 。 





El 
^ FE 





A^ 


选择 















































第 三 





上 向 量 w' = nxr =nx (uxn)。 我 们 需要 一 个 新 的 向 上 向 量 ， 
的 ， 或 彼此 垂直 。 十 算 过 程 中 ， 这 些 向 量 
单位 ， 从 而 创建 
个 向 量 ， 就 可 以 根据 


阵 尺 将 位 于 











应 用 这 个 旋转 矩阵 ， 将 带 纹理 





ANHE r, XH 


r， 都 在 四 边 形 的 平面 

















的 方向 : MB 


向 的 方 
量 需 要 对 准 该 向 量 ， 但 方向 相反 。 因 
边 形 的 法 线 向 量 应 该 指向 相反 
我 们 希望 方向 n= -v。 现 在 ， 选 择 一 个 向 量 u， 
ku 为 《0，0，1), 因 
因为 虽然 我 们 事先 知道 四 边 形 的 法 
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。 又 积 这 





Ba, Et 
建 一 个 正 交 坐标 系 
维 图 形 理 






























































论 ， 
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ede HE 








四 边 








多 所 在 的 平面 ， 





会 选择 四 边 形 的 ! 








心 。 
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不 知 























以 确保 这 
































所 有 向 量 是 单位 长 度 六 























10.1.6 ”生成 火花 动画 


要 生成 火花 喷泉 的 动画 ,就 要 利 























粒子 系统 的 各 个 位 置 。 


10.2 ”所 需 模 块 











我 们 将 

















数组 来 表示 三 





维 坐标 变换 矩阵 。 














10.3 ”粒子 系统 的 代码 














| GLFW 库 ， 通 过 


NS i 


E 确 地 对 准 观看 的 方向 ， 使 
































RIT 





开始 


























FETE MR! 





JATIN SELF. Me. B 





这 意味 着 设 
向 。 我 们 希望 四 边 形 面向 观看 的 方向 ， 即 
为 观看 的 方向 朝 
幕 向 外 。 


异 幕 ， 所 以 四 


这 是 四 边 形 最 终 位 置 的 
为 z 方向 指 “ 向 上 ”( 说 这 个 应 
EZR alee, fH 


量 是 近似 
道 摄像 头 的 方向 )。 然 后 
E r-uxn 《两 个 向 量 的 又 积 )。 现 在 有 了 两 个 正 交 向 量 ， 
两 个 向 量 ， 得 到 一 个 新 


nl 


向 量 。 因 此 ， 得 到 了 新 的 向 








Abs Rt: 








寸 更 新 演 染 和 时 间 ， 定 时 




















3 个 向 量 是 正 交 
都 需要 归 一 化 ， 让 长 度 等 于 一 个 
F 昌 正 交 )。 有 了 这 3 
一 个 旋转 矩阵 进行 任意 方向 的 旋转 。 旋 转 窍 
原点 的 正 交 坐标 系统 旋转 到 rr、w' RU 构成 的 4 


其 成 为 一 个 


绘制 





] PyOpenGL 《一 个 流行 的 Python OpenGL 绑 定 ) 来 泻 染 ， 用 numpy 的 


看 看 如 何 创建 动 
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10.3.1 

















画 中 粒子 之 间 的 时 间 延 迟 ， 如 何 为 粒子 设置 初始 速度 ， 





























以 及 如 何在 程序 中 使 ) 




















OpenGL 的 顶点 和 片段 着 色 器 。 最 后 ， 看 看 如 何 将 所 有 这 些 整 合 起 来 ， 泻 染 粒 子 系 

















统 。 整 个 项 目的 代码 ， 请 直接 跳 到 10.4 节 。 





喷泉 的 代码 封装 在 一 个 类 中 ， 名 为 ParticleSystem， 它 创建 了 粒子 系统 ， 建 
OpenGL 着 色 器 ， 用 OpenGL 演 染 系统 ， 每 隔 五 秒 钟 习 


























定义 粒子 的 几何 形状 


0000 























首先 ， 创 建 一 个 顶点 数组 对 象 CVBOO RE Ha SEAS T9 ex Je A 


这 些 粒子 的 几何 形状 。 


# create Vertex Array Object (VAO) 
self.vao = glGenVertexArrays(1) 

# bind VAO 
glBindVertexArray(self.vao) 









































开始 动 画 。 





每 个 粒子 是 一 个 正方 形 ， 其 顶点 和 纹理 坐标 定义 如 下 : 














# vertices 
Ss = 0.2 

quadV = [ 

-S, S, 0:0, 

-S, -S, 0.0, 

S, S, 0.0, 

S, -S, 0.0, 

S, S, 0.0, 

-S, -S, 0.0 

] 
vertexData = numpy.array(numP*quadV, numpy.float32) 
self.vertexBuffer = glGenBuffers(1) 
giBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


giBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 


GL STATIC DRAW) 


# texture coordinates 


quadT = [ 

0.0, 1.0, 
0.0, 0.0, 
1.0, 1.0, 
1.0, 0.0, 
1.0, 1.0, 
0.0, 0.0 
] 


tcData - numpy.array(numP*quadT, numpy.float32) 
self.tcBuffer = glGenBuffers(1) 
gliBindBuffer(GL ARRAY BUFFER, self.tcBuffer) 


giBufferData(GL ARRAY BUFFER, 4*len(tcData), tcData, GL STATIC DRAW) 


在 @ 行 ， 定义 了 正方 形 的 顶点 ， 各 边 以 原点 为 中 心 ， 长 度 为 0.4。 对 于 两 个 
GL TRIANGLES, 顶点 的 排序 是 相同 的 。 然 后 , 在 @ 行 , AE 
创建 一 个 numpy 数组 : 每 个 四 边 形 表示 系统 中 的 一 个 粒子 (所 有 要 绘制 的 几何 

















都 放 入 到 一 个 大 数组 )。 
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2 


M. 


了 


FE 数组 ， 从 而 定义 


E numP 次 ， 














图 











7 
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10.3.2 


10.3.3 











接 下 来 ， 将 这 些 顶 点 放 入 一 个 顶点 组 ; 

















区 对 象 ， 就 像 在 第 9 章 中 所 做 的 一 样 。 

















Ri 


FEO {THE VBO, 在 @ 行 绑 定 。 然 后 在 @ 行 ， 用 顶点 数据 填充 绑 定 的 缓冲 区 。 代 码 

















4 * len(vertexData) 指 明 在 vertexData 数组 中 ， 每 个 元 素 需 要 





4 个 字 节 。 


最 后 ， 在 @ 行 定义 四 边 形 的 纹理 坐标 ， 随 后 几 行 代码 设置 了 相关 的 VBO. 














为 粒子 定义 时 间 延 迟 数组 


接 下 来 ， 为 粒子 定义 时 间 延 迟 数组 。 我 们 希望 每 组 四 个 顶点 的 时 间 延 迟 一 样 ， 














这 代表 一 个 正方 形 的 粒子 ， 如 以 下 代码 所 示 : 


# time lags 


Th 





o timeData = numpy.repeat(0.005*numpy.arange(numP, dtype=numpy.float32) , 


4) 
self.timeBuffer = glGenBuffers(1) 
g1BindBuffer(GL_ARRAY_BUFFER, self.timeBuffer) 


giBufferData(GL ARRAY BUFFER, 4*len(timeData), timeData, 


GL STATIC DRAW) 


在 @ 行 ，numpyarangeO 创 建 了 一 个 数组 ， 包 含 不 断 增 





























加 的 值 ， 即 [0，1，.…， 


numP-1]。 将 这 个 数组 乘 以 0.005， 用 参数 4 调用 numpyxrepeat0， 产 生 一 个 数组 ， 即 
[0.0，0.0，0.0，0.0，0.005，0.005，0.005，0.005，...]。 接 下 来 的 代码 设置 了 VBO. 














设置 粒子 初始 速度 





接 下 来 生成 粒子 的 初始 速度 。 我 们 的 目标 是 生成 一 些 随机 的 速度 ， 它 们 与 垂直 























轴 的 夹 角 不 超过 茶 个 最 大 值 。 下 面 是 代码 : 


# velocites 

















velocities = [] 
# cone angle 
o coneAngle = math.radians(20.0) 


# set up particle velocities 
for i in range(numP) : 
# inclination 


e angleRatio - random.random() 
a - angleRatio*coneAngle 
# azimuth 
e t - random.random()*(2.0*math.pi) 
# get velocity on sphere 
(4) vx = math.sin(a)*math.cos(t) 
vy = math.sin(a)*math.sin(t) 
vz = math.cos(a) 
# speed decreases with angle 
e speed = 15.0*(1.0 - angleRatio*angleRatio) 
# add a set of calculated velocities 
[5] velocities += 6*[speed*vx, speed*vy, speed*vz] 


# set up velocity vertex buffer 
self.velBuffer = glGenBuffers(1) 
giBindBuffer(GL ARRAY BUFFER, self.velBuffer) 

o velData - numpy.array(velocities, numpy.float32) 





giBufferData(GL ARRAY BUFFER, 4*len(velData), velData, GL STATIC DRAW) 
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在 @ 行 ， 定 义 了 限制 喷 果 粒子 轨迹 的 锥 角 。( 注 意 ， 用 内 置 math.radians0 方 法 ， 
将 角度 转换 为 弧度 。) 接 下 来 ， 用 10.1.1 节 中 讨论 的 公式 ， 计 算 每 个 粒子 的 速度 。 

在 @ 行 ， 生 成 一 个 随机 分 数 ， 后 面 一 行 用 它 乘 以 最 大 倾斜 角 ， 来 计算 当前 倾斜 
角 。 接 着 ， 在 自行 生成 方位 角 ， 因 为 random.random() 返 回 值 在 [0，1] 之 间 ， 所 以 用 
该 值 乘 以 2.0* math.pi， 得 到 0 至 2 的 一 个 随机 弧度 。 

从 @ 行 开始 ， 利 用 球 坐 标 公 式 ， 计 算 单 位 球面 上 的 速度 向 量 。 在 @ 行 ， 用 @ 行 
得 到 的 角度 比 算出 一 个 速度 ， 它 与 垂直 角度 成 反比 。 在 @ 行 ,计算 粒子 的 最 终 速 度 ， 








































































































































































































并 针对 两 个 三 角形 的 所 有 6 个 顶点 ， 重 复 这 个 值 。 在 @ 行 ， 利 用 Eyton 列表 创建 一 
个 numpy 的 数组 ， 这 就 可 以 为 这 些 速度 创建 一 个 VBO 了 。 最 后 ， 启 用 所 有 的 顶点 
属性 ， 并 为 顶点 缓冲 区 设置 数据 格式 〈 因 为 这 个 过 程 类 似 于 第 9 章 ， 这 里 略 过 

接 讨论 顶点 着 色 器 )。 


10.3.4 创建 顶点 着 色 器 
顶点 着 色 器 处 理 各 个 顶点 ， 从 而 计算 粒子 系统 的 轨迹 。 下 面 是 它 的 代码 : 


#version 330 core 









































in vec3 aVel; 

in vec3 aVert; 

in float aTimeO; 
in vec2 aTexCoord; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
uniform mat4 bMatrix; 
uniform float uTime; 
uniform float uLifeTime; 
uniform vec4 uColor; 
uniform vec3 uPos; 


out vec4 vCol; 




























































































out vec2 vTexCoord; 

顶点 着 色 器 对 四 边 形 的 每 个 顶点 执行 ， 对 粒子 系统 中 的 所 有 四 边 形 。 它 首先 定 
义 属 性 数组 中 的 一 些 变量 , 它 代 表 要 传 入 VBO 的 数组 ,然后 定义 一 = uniform ERI, 
它们 在 执行 着 色 器 时 保持 不 变 。 最 后 定义 out 数量 ， 它 们 在 顶点 着 色 器 中 设置 ， 并 
传递 给 片段 着 色 器 进行 插值 。 


























现在 ， 来 看 看 着 色 器 的 maino Až: 


void main() { 
// set position 
float dt = uTime - aTime0; 
float alpha = clamp(1.0 - 2.0*dt/uLifeTime, 0.0, 1.0); 
if(dt < 0.0 || dt > uLifeTime || alpha < 0.01) { 
// out of sight! 
gl_Position = vec4(0.0, 0.0, -1000.0, 1.0); 

















0000 


154 Python 极 客 项 目 编程 


} 


else { 


// calculate new position 
vec3 accel = vec3(0.0, 0.0, 


// apply a twist 


-9.8); 


float PI = 3.14159265358979323846264; 
float theta = mod(100.0*length(aVel)*dt, 360.0)*PI/180.0; 


mat4 rot = mat4(vec4(cos(theta), sin(theta), 


0.0, 0.0), 


vec4(-sin(theta), cos(theta), 0.0, 0.0), 


vec4(0.0, 0.0, 


1.0, 0.0), 


vec4(0.0, 0.0, 0.0, 


// apply billboard matrix 
vec4 pos2 = bMatrix*rot*vec4(aVert, 


// calculate position 


1.0); 


vec3 newPos = pos2.xyz + uPos + aVel*dt + 0.5*accel*dt*dt; 


// apply transformations 


gl Position = uPMatrix * uMVMatrix * vec4(newPos, 1.0); 


} 

// set color 

vCol = vec4(uColor.rgb, 
// set texture coordinates 
vTexCoord = aTexCoord; 


alpha) ; 

















在 @ 行 ， 























让 粒子 逐渐 淡出 。 利 





针对 特定 的 粒子 计 香 
延迟 时 间 之 间 的 差 。 然 后 在 @ 行 为 顶点 计 入 
| GLSL 中 














为 了 在 粒子 生命 周期 弓 












































这 样 它 们 会 被 裁剪 掉 。 





构造 函数 中 的 设置 )， 或 者 














Zool 

























































































用 这 个 计算 出 的 角度 ， 
像 下 面 这 样 : 
| cos(O) 
R- —sin(Q) 
a 0.0 
0.0 
在 @ 行 ， 对 粒子 的 顶点 应 
板 旋 转 。 在 @ 行 ， 利 用 前 面 讨论 的 运动 方程 ， 
只 是 让 你 任 有 

















E JE FE MOR JE AY Lo 




















这 时 将 最 终 位 置 设 




















旋转 ， 使 





















































sin(@) 0.0 0.0] 
cos(O) 0.0 0.0 
0.0 0.0 0.0 
0.0 0.0 1.0] 


当前 经 过 的 时 间 ， 这 是 当前 时 间 步 又 与 该 粒子 的 
alpha 值 ， 该 值 随 着 时 间 的 流逝 而 减 小 ， 
的 clamp()， 将 值 限制 在 范围 0，1] 之 内 。 
吉 束 时 让 粒子 消失 ， 将 它们 放 在 OpenGL 的 视 锥 之 外 ， 
在 卓 行 ， 检 查 粒 子 的 生命 周期 是 否 结束 《根据 粒子 系统 
alpha 值 低 于 特定 值 ， 








置 到 视 锥 




















在 @ 行 ， 设 置 粒子 加 速度 为 9.8 米 / 秒 “， 即 由 于 地 球 引力 而 产生 的 加 速度 。 当 
粒子 以 较 高 的 初始 速度 飞 出 喷 录 时 ， 为 了 证 它们 快速 
于 Python 的 取 模 运算 %)， 在 @ 行 ， 将 角度 值 限于 

绕 四 边 形 的 z 轴 旋 转 ， 根 据 绕 z FA 


] mod0) 方 法 (类 似 
1 在 范围 [0，360] 之 内 。 在 @ 行 ， 利 
旋转 角度 的 变换 矩阵 公式 ， 




















j 两 个 转换 : 刚刚 计算 出 的 旋转 和 
前 位 置 ( 该 行 








计算 顶点 的 当 





第 10 章 粒子 系统 








] bMatrix 的 公告 




















的 uPos 
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在 @ 行 ， 对 粒子 位 置 应 用 模型 视图 
AJ BUB fas H] T 


置 的 颜色 和 纹理 
































坐标 ， 





点 的 alpha 信 。 




















































































































和 投影 矩阵 。 最 后 ， 












































针对 位 置 ^ 时 间 生 
针对 顶点 、 
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O00 站 AD 一 


.绘制 几 




















可 图 形 


IA o 









































让 我 们 来 看 看 实现 其 
公告 板 的 旋转 矩阵 


计算 


这 段 代码 计算 公 
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告 板 的 旋转 矩阵 : 











值 〈 请 注意 ， 在 四 行 基于 计 售 


在 @ 行 和 下 一 行 中 ， 设 


设置 顶 
















































































10.3.5 ”创建 片段 着 色 器 
现在 ， 来 看 看 片段 着 色 器 ， 它 设置 像素 的 颜色 。 
#version 330 core 
uniform sampler2D uSampler; 
in vec4 vCol; 
in vec2 vTexCoord; 
out vec4 fragColor; 
void main() { 
// get the texture color 
o vec4 texCol = texture2D(uSampler, vec2(vTexCoord.s, vTexCoord.t)); 
// multiply texture color by set vertex color; use the vertex color alpha 
e fragColor = vec4(texCol.rgb*vCol.rgb, vCol.a); 
} 
f.O47, FA GLSL 的 texture2D0O 方 法 ， 利 用 从 顶点 着 色 器 传 入 的 纹理 坐标 ， 为 
火花 图 像 查 找 基础 纹理 颜色 (从 用 作 纹 理 的 图 像 中 查找 的 颜色 )。 然 后 ， 将 这 个 纹 
里 颜 色 值 乘 以 火花 喷 果 的 颜色 ， 并 将 得 到 的 颜色 设置 给 输出 变量 fragColor@。 喷 果 
的 颜色 是 在 每 个 粒子 系统 重新 启动 时 , 由 ParticleSystem 的 restart0 方 法 随机 设置 的 。 
alpha 值 是 根据 顶点 着 色 器 中 的 计算 来 设置 的 ， 并 在 渲染 时 用 于 混合 。 
10.3.6 泻 染 
代码 按照 以 下 步骤 来 演 染 喷 果 粒子 系统 
.启用 顶点 /片断 程序 ; 
设置 模型 视图 和 投影 第 阵 ; 
基于 当前 摄像 机 的 观看 方向 ， 计 算 并 设置 公告 板 和 矩阵 ; 








些 步 骤 的 代码 片段 。 


命 周 期 和 颜色 ， 设 置 uniform 变量 ; 
纹理 坐标 、 时 间 延 迟 和 速度 ， 设 置顶 点 属性 数组 ; 
启用 纹理 并 绑 定 到 粒子 火花 纹理 ; 
深度 缓冲 写 入 ; 

] OpenGL 的 混合 ; 


occ 























N = camera.eye - camera.center 
N /= numpy.linalg.norm(N) 
U = camera.up 
U /= numpy.linalg.norm(U) 
R = numpy.cross(U, N) 
U2 = numpy.cross(N, R) 
bMatrix = numpy.array([R[O], U2[0], N[O], 0.0, 
R[1], U2[1], N[1], 0.0, 
R[2], U2[2], N[2], 0.0, 
0.0, 0.0, 0.0, 1.0], numpy.float32) 
glUniformMatrix4fv(self.bMatrixU, 1, GL TRUE, bMatrix) 
你 已 经 看 到 了 构造 一 个 旋转 矩阵 背后 的 理论 ， 该 矩阵 让 四 边 形 保持 为 “公告 
板 ”， 即 对 准 观看 方向 〈 这 是 必需 的 ， 以 便 让 喷泉 粒子 总 是 面 对 观 察 的 方向 )。 在 @ 
行 ， 用 numpy.linalg.norm() 对 癌 量规 一 化 (这 使 得 向 量 的 大 小 等 于 1)。 在 etr, T 
旋转 矩阵 组 装 为 一 个 numpy 数组 ， 然 后 在 目 行 将 它 放 入 程序 中 。 
主要 的 泻 染 代码 
We NUR ]alpha 混合 ， 让 粒子 系统 有 透明 性 。 这 种 技术 在 OpenGL 上 
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# enable texture 




















































































































































































































































































































glActiveTexture(GL TEXTUREO) 

giBindTexture(GL TEXTURE 2D, self.texid) 

glUniform1i(self.samplerU, 0) 

# turn depth mask off 

if self.disableDepthMask: 
giDepthMask(GL FALSE) 

# enable blending 

if self.enableBlend: 
glBlendFunc(GL SRC ALPHA, GL ONE) 
glEnable(GL BLEND) 

# bind VAO 

glBindVertexArray(self.vao) 

# draw 

glDrawArrays(GL_TRIANGLES, 0, 6*self.numP) 

在 @ 行 ， 激活 第 一 个 OpenGL 纹理 单元 (GL_TEXTURE0)。 我 们 只 有 一 个 纹理 
单元 ， 但 由 于 在 OpenGL 上 下 文中 ， 同 一 时 间 可 以 激活 多 个 纹理 单元 ， 所 以 针对 每 
个 纹理 单元 显 式 调用 是 良好 的 编程 习惯 。 在 @ 行 ， 激 活 纹理 对 象 ， 它 是 在 
ParticalSystem 的 构造 函数 中 ， 利 用 glutils.loadTexture0 和 火花 图 像 创 建 的 。 

纹理 利用 采样 在 着 色 器 中 访问 ， 在 @ 行 ， 设 置 采样 变量 使 用 第 一 个 纹理 单元 
GL_TEXTURE0。 然 后 ， 利 用 OpenGL 混合 切除 纹理 中 的 黑色 像素 ， 但 这 些 “ 看 不 
见 ” 的 像素 仍然 具有 关联 的 深度 值 ， 可 以 掩盖 那些 在 它们 后 面 的 、 其 他 粒子 的 某 些 


部 

















分 。 为 了 避免 这 种 情况 ， 

















在 @ 行 禁用 深度 缓存 写 入 。 
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注意 严格 来 说 ， 这 是 错误 的 绘制 方式 ， 因 为 如 果 混 合 这 些 半 透 明 的 物体 和 不 透 
明 的 物体 ， 它 们 的 深度 测试 就 不 正确 。 泻 染 这 样 的 场景 ， 正 确 的 做 法 应 该 是 先 
绘制 不 透明 的 物体 ， 然 后 启用 混合 ， 按 深度 从 后 到 前 对 半 透 明 物 体 排序 ， 最 后 
绘制 它们 。 但 是 ， 因 为 有 这 么 多 运动 的 粒子 ， 这 个 简单 的 近似 是 可 以 接受 的 ， 
而 且 最 后 ， 它 看 起 来 不 错 ， 而 这 才 是 你 关心 的 。 


在 @ 行 , 设置 OpenGL 混合 功能 ， 以 便 使 用 从 片段 着 色 器 传 入 的 源 像 素 的 alpha 





















































& If 
值 ， 在 @ 行 ， 启 用 OpenGL 混合 。 然 后 ， 在 @ 行 绑 定 到 创建 的 VAO， 这 启用 了 你 建 
立 的 所 有 的 顶点 属性 ， 在 @ 行 ， 在 屏幕 上 绘制 绑 定 的 项 点 缓冲 区 对 象 。 

































































10.3.7 Camera 类 
最 后 ，Camera 类 设置 了 OpenGL 的 观看 参数 : 


# a simple camera class 
class Camera: 
"""helper class for viewing""" 
o def | init (self, eye, center, up): 

self.r - 10.0 
self.theta - O 
self.eye - numpy.array(eye, numpy.float32) 
self.center - numpy.array(center, numpy.float32) 
self.up = numpy.array(up, numpy.float32) 

















def rotate(self): 
"""rotate eye by one step""" 
e self.theta = (self.theta + 1) % 360 
# recalculate eye 
e self.eye = self.center + numpy.array([ 


self.r*math.cos(math.radians(self.theta)), 
self.r*math.sin(math.radians(self.theta)), 
0.0], numpy. float32) 


三 维 立体 图 的 特征 通常 在 于 3 个 参数 : 眼睛 位 置 、 向 上 向 量 和 方向 向 量 。Camera 
类 包含 这 些 参数 ， 并 提供 了 一 种 便捷 的 方式 ， 在 每 一 个 时 间 步 又 旋转 。 
在 @ 行 的 构造 函数 设置 了 camera 对 象 的 初始 值 。 调 用 rotate() 方 法 时 ， 增 加 旋 
转角 度 @@， 并 计算 旋转 后 新 的 眼睛 位 置 和 方向 目 。 


注意 点 (r cos(6), rsin(0)) 表 示 一 个 点 ， 它 在 以 原点 为 中 心 、 半 径 为 上 的 图 上 ， 
0 是 该 点 到 原点 的 连 线 与 x 轴 的 夹 角 。 转换 中 使 用 了 center， 确 保 即 使 旋转 中 
心 不 在 原 点 ， 也 能 工作 。 











































































































10.4 ”粒子 系统 完整 代码 
这 是 粒子 系统 的 完整 代码 。 也 可 以 在 https://github.com/electronut/pp/tree/master/ 
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particle-system/ps.py 找到 它 。 


import sys, random, math 
import OpenGL 

from OpenGL.GL import * 
import numpy 

import glutils 


strvS = """ 
#version 330 core 


in vec3 aVel; 

in vec3 aVert; 

in float aTimeO; 
in vec2 aTexCoord; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
uniform mat4 bMatrix; 
uniform float uTime; 
uniform float uLifeTime; 
uniform vec4 uColor; 
uniform vec3 uPos; 


out vec4 vCol; 
out vec2 vTexCoord; 


void main() ( 
// set position 
float dt = uTime - aTimeO; 
float alpha = clamp(1.0 - 2.0*dt/uLifeTime, 0.0, 1.0); 
if(dt « 0.0 || dt > uLifeTime || alpha « 0.01) { 
// out of sight! 
gl Position = vec4(0.0, 0.0, -1000.0, 1.0); 
} 
else { 
// calculate new position 
vec3 accel = vec3(0.0, 0.0, -9.8); 
// apply a twist 
float PI = 3.14159265358979323846264; 
float theta = mod(100.0*length(aVel)*dt, 360.0)*PI/180.0; 
mat4 rot = mat4(vec4(cos(theta), sin(theta), 0.0, 0.0), 
vec4(-sin(theta), cos(theta), 0.0, 0.0), 
vec4(0.0, 0.0, 1.0, 0.0), 
vec4(0.0, 0.0, 0.0, 1.0)); 
// apply billboard matrix 
vec4 pos2 = bMatrix*rot*vec4(aVert, 1.0); 
// calculate position 
vec3 newPos = pos2.xyz + uPos + aVel*dt + 0.5*accel*dt*dt; 
// apply transformations 
gl Position = uPMatrix * uMVMatrix * vec4(newPos, 1.0); 
} 
// set color 
vCol = vec4(uColor.rgb, alpha); 
// set tex coords 
vTexCoord = aTexCoord; 


} 


strFS = """ 
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#version 330 core 


uniform sampler2D uSampler; 
in vec4 vCol; 

in vec2 vTexCoord; 

out vec4 fragColor; 


void main() { 
// get texture color 
vec4 texCol = texture(uSampler, vec2(vTexCoord.s, vTexCoord.t)); 
// multiply by set vertex color; use the vertex color alpha 
fragColor = vec4(texCol.rgb*vCol.rgb, vCol.a); 


# a simple camera class 
class Camera: 
"""helper class for viewing""" 
def | init (self, eye, center, up): 
self.r - 10.0 
self.theta - O 
self.eye - numpy.array(eye, numpy.float32) 
self.center - numpy.array(center, numpy.float32) 
self.up - numpy.array(up, numpy.float32) 


def rotate(self): 

"""rotate eye by one step""" 

self.theta = (self.theta + 1) % 360 

# recalculate eye 

self.eye = self.center + numpy.array([ 
self.r*math.cos(math.radians(self.theta)), 
self.r*math.sin(math.radians(self.theta)), 
0.0], numpy.float32) 


# particle system class 
class ParticleSystem: 


# initialization 
def | init__(self, numP): 
# number of particles 
self.numP = numP 
# time variable 
self.t = 0.0 
self.lifeTime = 5.0 
self.startPos = numpy.array([0.0, 0.0, 0.5]) 
# load texture 
self.texid = glutils.loadTexture('star.png') 
# create shader 
self.program = glutils.loadShaders(strVS, strFS) 
glUseProgram(self.program) 


# set sampler 
texLoc = glGetUniformLocation(self.program, b"uTex") 
glUniform1i(texLoc, 0) 


# uniforms 

self.timeU = glGetUniformLocation(self.program, b"uTime") 
self.lifeTimeU = glGetUniformLocation(self.program, b'uLifeTime") 
self.pMatrixUniform - glGetUniformLocation(self.program, b'uPMatrix') 
self.mvMatrixUniform = glGetUniformLocation(self.program, b'uMVMatrix") 
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self.bMatrixU = glGetUniformLocation(self.program, b"bMatrix") 


self.colorU = glGetUniformLocation(self.program, b"uColor") 


self.samplerU = glGetUniformLocation(self.program, b"uSampler") 


self.posU = glGetUniformLocation(self.program, b"uPos") 


# attributes 
self.vertIndex = glGetAttribLocation(self.program, b"aVert") 


self.texIndex = glGetAttribLocation(self.program, b"aTexCoord" ) 
self.timeOIndex = glGetAttribLocation(self.program, b"aTimeO") 


self.velIndex = glGetAttribLocation(self.program, b"aVel") 


# render flags 
self.enableBillboard = True 
self.disableDepthMask = True 
self.enableBlend = True 


# which texture to use 
self.useStarTexture = True 
# restart - first time 
self .restart(numP) 


# step 

def step(self): 
# increment time 
self.t += 0.01 


# restart particle system 

def restart(self, numP): 
# set number of particles 
self.numP = numP 


# time variables 
self.t = 0.0 
self.lifeTime = 5.0 


# color 
self.colO = numpy.array([random.random(), random.random() , 
random.random(), 1.0]) 


# create Vertex Arrays Object (VAO) 

self.vao = glGenVertexArrays(1) 

# bind VAO 

glBindVertexArray(self.vao) 

# create attribute arrays and vertex buffers: 


# vertices 


s = 0.2 

quadV = [ 
-s, s, 0.0, 
-s, -S, 0.0, 
s, s, 0.0, 
S, -S, 0.0, 
s, s, 0.0, 
-s, -S, 0.0 


] 
vertexData = numpy.array(numP*quadV, numpy.float32) 
self.vertexBuffer = glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
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GL_STATIC_DRAW) 


# texture coordinates 


quadT = [ 
0.0, 1.0, 
0.0, 0.0, 
1.0, 1.0, 
1.0, 0.0, 
1.0, 1.0, 
0.0, 0.0 


] 
tcData = numpy.array(numP*quadT, numpy.float32) 
self.tcBuffer = glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.tcBuffer) 
giBufferData(GL ARRAY BUFFER, 4*len(tcData), tcData, GL STATIC DRAW) 


# time lags 
timeData = numpy.repeat(0.005*numpy.arange(numP, dtype-numpy.float32), 
4) 
self .timeBuffer = glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.timeBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(timeData), timeData, 
GL STATIC DRAW) 
# velocites 
velocities - [] 
# cone angle 
coneAngle = math.radians(20.0) 
# set up particle velocities 
for i in range(numP): 
# inclination 
angleRatio = random.random() 
a = angleRatio*coneAngle 
# azimuth 
t = random.random()*(2.0*math.pi) 
# get veocity on sphere 
vx = math.sin(a)*math.cos(t) 
vy = math.sin(a)*math.sin(t) 
vz = math.cos(a) 
# speed decreases with angle 
speed = 15.0*(1.0 - angleRatio*angleRatio) 
# add a set of calculated velocities 
velocities += 6*[speed*vx, speed*vy, speed*vz] 
# set up velocity vertex buffer 
self.velBuffer = glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.velBuffer) 
velData - numpy.array(velocities, numpy.float32) 
glBufferData(GL ARRAY BUFFER, 4*len(velData), velData, GL STATIC DRAW) 


# enable arrays 

glEnableVertexAttribArray 
glEnableVertexAttribArray 
glEnableVertexAttribArray 
glEnableVertexAttribArray 


self .vertIndex) 
self .texIndex) 
self .timeOIndex) 
self.velIndex) 


# set buffers 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glVertexAttribPointer(self.vertIndex, 3, GL FLOAT, GL FALSE, 0, None) 


glBindBuffer(GL ARRAY BUFFER, self.tcBuffer) 
glVertexAttribPointer(self.texIndex, 2, GL FLOAT, GL FALSE, 0, None) 
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giBindBuffer(GL ARRAY BUFFER, self.velBuffer) 
glVertexAttribPointer(self.velIndex, 3, GL FLOAT, GL FALSE, 0, None) 


glBindBuffer(GL ARRAY BUFFER, self.timeBuffer) 
glVertexAttribPointer(self.timeOIndex, 1, GL FLOAT, GL FALSE, 0, None) 


# unbind VAO 
glBindVertexArray (0) 


# render the particle system 

def render(self, pMatrix, mvMatrix, camera): 
# use shader 
glUseProgram(self.program) 


# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL FALSE, pMatrix) 


# set modelview matrix 

glUniformMatrix4fv(self.mvMatrixUniform, 1, GL FALSE, mvMatrix) 

# set up a billboard matrix to keep quad aligned to view direction 
if self.enableBillboard: 


- numpy.linalg.norm(U) 
numpy.cross(U, N) 
2 - numpy.cross(N, R) 
bMatrix = numpy.array([R[O], U2[0], N[O], 0.0, 
R[1], U2[1], N[1], 0.0, 
R[2], U2[2], N[2], 0.0, 
0.0, 0.0, 0.0, 1.0], numpy.float32) 
glUniformMatrix4fv(self.bMatrixU, 1, GL TRUE, bMatrix) 
else: 
# identity matrix 
bMatrix = numpy.array([1. 


/ 
= camera.up 
/ 


= J 
= 3 
], numpy.float32) 


0 
0， 
0 
, 0. 0 
trixU, 1, GL FALSE, bMatrix) 


1.0, 0 0 
0.0, 1 0 
0.0, 0. ,0 
0.0, 0 1. 
glUniformMatrix4fv(self.bMatr L 
# Set Start position 

glUniform3fv(self.posU, 1, self.startPos) 

# set time 

glUniformif(self.timeU, self.t) 

#set lifetime 

glUniformif(self.lifeTimeU, self.lifeTime) 

# set color 

glUniform4fv(self.colorU, 1, self.colO) 


# enable texture 

glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texid) 
glUniform1i(self.samplerU, 0) 


# turn depth mask off 
if self.disableDepthMask: 
glDepthMask(GL_FALSE) 


# enable blending 
if self.enableBlend: 
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giBlendFunc(GL SRC ALPHA, GL ONE) 
glEnable(GL BLEND) 


# bind VAO 

glBindVertexArray(self.vao) 

# draw 

glDrawArrays(GL_TRIANGLES, 0, 6*self.numP) 
# unbind VAO 

giBindVertexArray (0) 


# disable blend 
if self.enableBlend: 
giDisable(GL BLEND) 


# turn depth mask on 
if self.disableDepthMask: 
glDepthMask(GL TRUE) 


# disable texture 
glBindTexture(GL TEXTURE 2D, 0) 


这 是 火花 喷泉 的 所 有 代码 ,但 我 们 还 要 画 一 个 红色 的 盒子 代表 喷泉 粒子 系统 的 
来 源 。 





10.5 盒子 代码 
要 让 观众 的 注意 力 集中 于 喷泉 ， 只 要 画 一 个 没有 任何 灯光 的 红色 立方 体 就 行 了 。 


import sys, random, math 
import OpenGL 

from OpenGL.GL import * 
import numpy 

import glutils 























strvS = """ 
#version 330 core 


in vec3 aVert; 
uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
out vec4 vCol; 


void main() { 
// apply transformations 
gl_Position = uPMatrix * uMVMatrix * vec4(aVert, 1.0); 
// set color 
vCol = vec4(0.8, 0.0, 0.0, 1.0); 
} 


StrFS = """ 
#version 330 core 


in vec4 vCol; 
out vec4 fragColor; 


void main() { 
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// use vertex color 


fragColor = 


} 


class Box: 


vCol; 


def _init (self, side): 
self.side = side 


# load 


shaders 


self.program = glutils.loadShaders(strVS, 
glUseProgram(self.program) 


s = side/2.0 


vertices 


-S, 


= 
S, -S, 
7$, -S, 


# set up vertex array object (VAO) 


strFS) 
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def 


self.vao = glGenVertexArrays(1) 
glBindVertexArray (self .vao) 

# set up VBOs 

vertexData = numpy.array(vertices, numpy.float32) 
self.vertexBuffer = glGenBuffers(1) 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 


GL STATIC DRAW) 
#enable arrays 


self.vertIndex = glGetAttribLocation(self.program, "aVert") 


glEnableVertexAttribArray(self.vertIndex) 
# set buffers 
gliBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 


glVertexAttribPointer(self.vertIndex, 3, GL FLOAT, GL FALSE, O, None) 


# unbind VAO 
glBindVertexArray (0) 


render(self, pMatrix, mvMatrix): 


# use shader 
glUseProgram(self.program) 


# set projection matrix 

glUniformMatrix4fv(glGetUniformLocation(self.program, 
1, GL FALSE, pMatrix) 

# set modelview matrix 

glUniformMatrix4fv(glGetUniformLocation(self.program, 
1, GL_FALSE, mvMatrix) 

# bind VAO 

glBindVertexArray (self .vao) 

# draw 

glDrawArrays(GL_TRIANGLES, 0, 36) 

# unbind VAO 

glBindVertexArray (0) 
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o 












































该 项 目的 主 程序 源 文件 是 psmain.py, EWE I GLEW f 
并 创建 粒子 系统 。 如 果 想 看 到 完整 的 程序 代码 ， 请 跳 到 10.7 Ti. 


























class PSMaker: 


"""GLFW Rendering window class for Particle System""" 


def _ init__(self): 
self.camera = Camera([15.0, 0.0, 2.5], 
[0.0, 0.0, 2. 

0.0, 1 


self.aspect = 1.0 

self.numP = 300 

self.t = 0 

# flag to rotate camera view 
self.rotate = True 


# save current working directory 
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'uPMatrix'), 


‘uMVMatrix'), 








H 





























盒子 的 代码 使 用 简单 的 顶点 和 片段 着 色 器 来 绘制 一 个 立方 体 。 这 里 使 用 的 概念 
与 本 章 前 面 和 第 9 章 中 讨论 的 相同 。 





tT 








pu 


， 处 理 了 键盘 事件 ， 





cwd = os.getcwd() 


# initialize glfw; this changes cwd 
e glfw.glfwInit() 


# restore cwd 
os.chdir (cwd) 


# version hints 

glfw.glfwindowHint (glfw.GLFW_CONTEXT_VERSION_MAJOR, 3) 

glfw.glfwindowHint (glfw.GLFW_CONTEXT_VERSION_MINOR, 3) 

glfw.glfwWindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 

glfw.glfwWindowHint(glfw.GLFW OPENGL PROFILE, 
glfw.GLFW OPENGL CORE PROFILE) 


# make a window 

self.width, self.height - 640, 480 

self.aspect = self.width/float(self.height) 

self.win - glfw.glfwCreateWindow(self.width, self.height, 
b"Particle System") 


# make context current 
glifw.glfwMakeContextCurrent (self.win) 


# initialize GL 

glViewport(0, 0, self.width, self.height) 
glEnable(GL_DEPTH_TEST) 

glClearColor(0.2, 0.2, 0.2,1.0) 


# set window callbacks 
glfw.glfwSetMouseButtonCallback(self.win, self .onMouseButton) 
glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


# create 3D 
e self.psys = ParticleSystem(self.numP) 
o self.box = Box(1.0) 

# exit flag 
e self.exitNow - False 














类 PSMaker 创建 粒子 系统 ， 处 理 GLFW 窗口 ， 并 负责 泻 染 喷泉 和 表示 其 源头 
的 盒子 。 在 @ 行 ， 创 建 一 个 Camera 对 象 ， 它 可 以 用 于 在 OpenGL 中 设置 观看 参数 。 
从 @ 行 开始 的 代码 块 设置 了 GLFW 窗口 ， 在 上 日 行 ， 创 建 ParticleSystem 对 象 ， 在 @ 
行 ， 创 建 Box 对 象 。 在 @ 行 ， 是 在 主 GLEW 演 染 循环 中 使 用 的 退出 标志 ， 接 下 来 你 





















































10.6.1 每 步 更 新 这 些 粒 子 
a ee 我 们 创建 了 动画 。 主 程序 循环 进而 又 
更 新 顶点 着 色 器 中 的 时 间 变量 。 用 这 个 新 时 间 值 ， 计 算 并 泻 染 下 一 帧 ， 从 而 更 新 这 
些 粒子 的 位 置 。 着 色 器 计算 粒子 的 新 朝向 ， 也 让 它们 旋转 。 此 外 ， 着色 器 计算 alpha 
值 ， 它 是 时 间 变 量 的 函数 ， 将 用 于 最 后 的 泻 染 ， 实 现 火花 逐渐 淡 
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step( 方 法 为 每 个 时 间 步 又 更 新 粒子 系统 。 


def step(self): 
# increment time 
o self.t += 10 
e self.psys.step() 
# rotate eye 
if self.rotate: 
e self.camera.rotate() 
# restart every 5 seconds 
if not int(self.t) % 5000: 
o self.psys.restart(self.numP) 


在 @ 行 ， 增 加 时 间 变 量 ， 它 以 毫秒 为 单位 记录 流逝 的 时 间 。 在 @ 行 ， 调 用 
ParticleSystem 的 step(0 方 法 ， 这 样 它 可 以 自行 更 新 。 如 果 设 置 了 标志 ， 就 在 目 行 旋 
转 相 机 。 每 5 秒 钟 〈5000 毫秒 )， 粒 子 系统 在 @ 行 重新 启动 





Du. 


ui 



































10.6.2 键盘 处 理 程序 
现在 ， 来 看 看 GLFW 窗口 的 键盘 处 理 程序 。 


o def onKeyboard(self, win, key, scancode, action, mods): 
#print ‘keyboard: ', win, key, scancode, action, mods 
if action -- glfw.GLFW PRESS: 
# ESC to quit 
if key -- glfw.GLFW KEY ESCAPE: 
self.exitNow - True 
elif key -- glfw.GLFW KEY R: 
self.rotate - not self.rotate 
elif key -- glfw.GLFW KEY B: 
# toggle billboarding 
self.psys.enableBillboard = not self.psys.enableBillboard 
elif key == glfw.GLFW_KEY_D: 
# toggle depth mask 
self.psys.disableDepthMask = not self.psys.disableDepthMask 
elif key == glfw.GLFW_KEY_T: 
# toggle transparency 
self.psys.enableBlend = not self.psys.enableBlend 


@ 行 的 键盘 处 理 程序 ， 主 要 在 关闭 用 于 绘制 粒子 系统 的 各 种 泻 染 技巧 时 ， 让 你 
民 容 易 看 到 所 发 生 的 事情 。 这 段 代码 让 你 切换 旋转 、 公 告 板 、 深 度 遮掩 和 透明 度 。 
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10.6.3 ”管理 主 程序 循环 
使 用 GLFW 时 ， 必 须 管理 自己 的 主 程序 循环 。 下 面 是 这 个 程序 中 使 用 的 循环 : 



























































def run(self): 
# initializer timer 
glfw.SetTime (0) 


t = 0.0 
o while not glfw.glfwWindowShouldClose(self.win) and not self.exitNow: 
# update every x seconds 
e currT = glfw.glfwGetTime() 


if currT - t > 0.01: 
# update time 
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t = currT 


# clear 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 





# render 

pMatrix = glutils.perspective(100.0, self.aspect, 0.1, 100.0) 

# modelview matrix 

mvMatrix = glutils.lookAt(self.camera.eye, self.camera.center, 
self.camera.up) 


# draw nontransparent object first 


e self.box.render(pMatrix, mvMatrix) 
# render 

o self.psys.render(pMatrix, mvMatrix, self.camera) 
# step 

[5] self.step() 


gifw.glfwSwapBuffers(self.win) 
# poll for and process events 
glfw.glfwPollEvents() 
# end 
glfw.glfwTerminate() 


这 段 代 码 与 第 9 章 中 使 用 的 循环 几乎 是 相同 的 。 在 @ 行 ， 如 果 exit 标志 已 设置 
或 GLFW 窗口 关闭 ，while 循环 就 退出 。 在 @ 行 和 后 面 一 行 ， 使 用 GLFW 计时 器 ， 
仅 当 时 间 流 逝 一 定量 〈0.1 秒 ) 时 才 进 行 泻 染 ， 从 而 控制 泻 染 的 帧 速率 。 在 @ 行 绘制 
盒子 ， 在 @ 行 绘制 粒子 系统 〔 演 染 的 顺序 很 重要 : 透明 物体 总 是 最 后 绘制 ， 这 样 它 
们 能 够 与 场景 中 不 透明 的 物体 正确 地 混合 和 深度 绥 冲 )。 在 @ 行 , 针对 当前 时 间 步 又 
更 新 粒子 系统 。 





























































































































10.7 完整 主 程序 代码 


下 面 是 psmain.py 的 完整 代码 。 也 可 以 在 https://github.com/electronut/pp/tree/ 
master/particle-system/ 找 到 这 段 代 码 。 


import sys, os, math, numpy 

import OpenGL 

from OpenGL.GL import * 

import numpy 

from ps import ParticleSystem, Camera 
from box import Box 

import glutils 

import glfw 

















class PSMaker: 
"""GLFW Rendering window class for Particle System""" 

def _ init__(self): 
self.camera = Camera([15.0, 0.0, 2.5 
[0 . ] 
] 


aN 
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self.aspect = 1.0 

self.numP = 300 

self.t = 0 

# flag to rotate camera view 
self.rotate = True 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw; this changes cwd 
glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 
glfw.glfwWindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 
glfw.glfwWindowHint(glfw.GLFW CONTEXT VERSION MINOR, 3) 
gifw.glfwWindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 
gifw.glfwWindowHint(glfw.GLFW OPENGL PROFILE, 
glfw.GLFW OPENGL CORE PROFILE) 


# make a window 

self.width, self.height - 640, 480 

self.aspect - self.width/float(self.height) 

self.win - glfw.glfwCreateWindow(self.width, self.height, 
b"Particle System") 

# make context current 

gifw.glfwMakeContextCurrent (self.win) 


# initialize GL 

glViewport(0, 0, self.width, self.height) 
glEnable(GL DEPTH TEST) 

glClearColor(0.2, 0.2, 0.2,1.0) 


# set window callbacks 
glfw.glfwSetMouseButtonCallback(self.win, self.onMouseButton) 
glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


# create 3D 
self.psys = ParticleSystem(self.numP) 
self.box = Box(1.0) 


# exit flag 
self.exitNow - False 


def onMouseButton(self, win, button, action, mods): 
#print 'mouse button: ', win, button, action, mods 
pass 


def onKeyboard(self, win, key, scancode, action, mods): 
#print ‘keyboard: ', win, key, scancode, action, mods 
if action == glfw.GLFW_PRESS: 
# ESC to quit 
if key == glfw.GLFW_KEY_ESCAPE: 
self.exitNow = True 
elif key == glfw.GLFW_KEY_R: 
self.rotate = not self.rotate 
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def 


def 


def 


elif key == glfw.GLFW_KEY_B: 

# toggle billboarding 

self.psys.enableBillboard = not self.psys.enableBillboard 
elif key == glfw.GLFW_KEY_D: 

# toggle depth mask 

self.psys.disableDepthMask = not self.psys.disableDepthMask 
elif key == glfw.GLFW_KEY_T: 

# toggle transparency 

self.psys.enableBlend = not self.psys.enableBlend 


onSize(self, win, width, height): 

#print ‘onsize: ', win, width, height 
self.width = width 

self.height = height 

self.aspect = width/float(height) 
glViewport(0, 0, self.width, self.height) 


step(self): 

# increment time 

self.t += 10 

self .psys.step() 

# rotate eye 

if self.rotate: 
self.camera.rotate() 

# restart every 5 seconds 

if not int(self.t) % 5000: 
self.psys.restart(self.numP) 


run(self): 
# initializer timer 
glfw.glfwSetTime (0) 
t = 0.0 
while not glfw.glfwWindowShouldClose(self.win) and not self.exitNow: 
# update every x seconds 
currT = glfw.glfwGetTime() 
if currT - t > 0.01: 
# update time 
t = currT 


# clear 
giClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 





# render 

pMatrix = glutils.perspective(100.0, self.aspect, 0.1, 100.0) 

# modelview matrix 

mvMatrix = glutils.lookAt(self.camera.eye, self.camera.center, 
self .camera.up) 


# draw nontransparent object first 
self .box.render(pMatrix, mvMatrix) 


# render 
self.psys.render(pMatrix, mvMatrix, self.camera) 


# step 
self.step() 


glfw.glfwSwapBuffers (self .win) 


# poll for and process events 
glfw.glfwPollEvents() 


第 10 章 粒子 系统 


171 


# end 
glfw.glfwTerminate() 


# main() function 

def main(): 
# use sys.argv if needed 
print('starting particle system...') 
prog = PSMaker() 
prog.run() 


# call main 
if name == ' main 
main() 





=T e 
10.8 ”运行 程序 
要 运行 该 项 目 ， 请 输入 以 下 命令 : 
$ python3 psmain.py 


本 章 开 始 的 图 10-1 展示 了 输出 。 























10.9 小 结 

















本 章 用 Python 和 OpenGL 创建 了 喷泉 粒子 系统 ,我 们 学 习 了 创建 粒子 系统 的 数 
学 模型 , 建立 了 着 色 器 程序 , 并 利用 了 一 些 OpenGL 技巧 ， 以 逼真 的 方式 泻 染 粒子 。 























10.10 ”实验 
下 面 有 一 些 想 法 ， 可 以 用 更 多 的 方式 来 试验 粒子 系统 动画 。 
1. 如 果 每 个 粒子 的 喷射 没有 时 间 延 迟 ， 看 看 情况 如 何 。 
2. 让 喷泉 中 的 粒子 在 喷射 时 逐渐 变 大 (提示 : 缩放 顶点 着 色 器 的 四 顶点 )。 
3. 这 些 代 码 让 每 个 粒子 遵循 完美 的 抛物 线 ， 因 为 它 从 喷泉 喷 出 。 请 为 粒子 的 
路 径 增 加 一 些 随机 性 (提示 : 研究 GLSL 的 noise0 方 法 ， 你 可 以 在 顶点 着 色 器 中 
使 用 )。 
4. 在 喷泉 中 的 粒子 遵循 抛物 线 轨迹 ， 上 升 ， 然 后 由 于 重力 作用 下 落 。 你 能 让 它 
们 跌落 到 地 板 时 反弹 吗 ? 可 能 需要 增加 粒子 的 寿命 来 实现 (提示 : 地 板 位 于 z = 0.0 
处 。 在 顶点 着 色 器 中 ， 当 粒子 接近 地 面 时 ， 反 转速 度 的 z 分 量 )。 
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MRI 和 CT 扫描 这 样 的 诊断 过 程 会 创建 体 数据 , 它 由 一 组 二 维 图 
像 来 表示 通过 三 维 物体 的 截面 。 体 绘制 是 一 种 计算 机 图 形 技术 ， 
利用 这 种 类 型 的 体 数 据 来 构造 三 维 图 像 。 虽 然 体 绘制 通常 用 于 分 
析 医 学 扫描 ,但 也 可 以 用 于 地 质 、 考 古 和 分 子 生物 学 等 学 科 , AE 
成 三 维 科 学 可 视 化 效果 。 

由 MRI 和 CT 扫描 记录 的 数据 通常 采取 N; XNyX NN; 的 三 维 
网 格 形式 ， 或 N;, 个 二 维 “ 切 片 ”” 其 中 每 个 切片 是 大 小 为 NXNy 的 图 像 。 体 绘制 
算法 采用 某 种 类 型 的 透明 度 ， 来 展示 采集 切片 数据 ， 并 采用 各 种 技术 来 强调 被 泻 染 
物体 中 关注 的 部 分 。 

本 项 目 将 探讨 名 为 “ 体 光 线 投射 (volume ray casting )” 的 体 绘制 算法 ， 它 充 
分 利用 图 形 处 理 单元 (GPU), H OpenGL 着 色 语 言 (GLSL) 的 着 色 器 来 进行 计 
算 。 代 码 针 对 屏幕 上 的 每 个 像素 执行 ， 并 利用 了 GPU， 其 目的 是 有 效 地 进行 并 行 
计算 。 利 用 二 维 图 像 文 件 夹 中 包含 的 三 维 数据 集 切 片 ， 用 体 光 线 投射 算法 ， 构 建 
体 泻 染 图 像 。 我 们 还 会 实现 一 种 方法 ， 显 示 在 x. y. z 方向 上 的 二 维 切片 数据 ， 
以 便 用 户 可 以 通过 箭头 键 来 滚动 切片 。 键 盘 命令 让 用 户 在 三 维 泻 染 和 二 维 切片 之 
间 切 换 。 


















































































































































































































































































































































































































































下 面 是 本 项 目 









































涉及 的 一 些 主 
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用 GLSL 进行 GPU 计算 ; 

























































































































































































































































































。 创建 顶点 和 片段 着 色 器 ; 
。 表示 三 维 立 体 数据 ， 并 使 用 体 光 线 投射 算法 
。 用 numpy 数组 表示 三 维 变换 矩阵 。 
11.1 工作 原理 

有 许多 方式 来 泻 染 三 维 数据 集 。 本 项 目 将 使 用 体 光 线 投 射 的 方法 ， 它 是 基于 图 
像 的 演 染 技术 ， 从 二 维 切片 逐个 像素 地 生成 最 终 图 像 的 。 与 此 形成 对 比 的 是 ， 典 型 
的 三 维 泻 染 方法 是 基于 对 象 的 : 它们 开始 用 三 维 对 象 表示 ， 然 后 应 用 变换 来 生成 投 
射 的 二 维 图 像 中 的 像素 。 

在 本 项 目 用 到 的 体 光 线 投射 方法 中 ， 对 于 输出 图 像 中 的 每 个 像素 ， 一 束 光 线 射 
入 离散 的 三 维 体 数 据 集 ， 其 通常 表示 为 一 个 长 方 体 。 随 着 光线 穿 过 物体 ， 数 据 以 一 
定 的 间隔 采样 ， 样 本 被 组 合 ( 或 “合成”) 来 计算 最 终 图 像 的 颜色 值 或 强度 你 可 
以 认为 这 个 过 程 类 似 于 堆 登 一 些 透 明胶 片 ， 将 它们 放 在 强 光 下 ， 看 到 所 有 的 胶片 组 
合 的 效果 )。 


体 光线 投射 泻 染 的 实现 通常 使 
过 滤 来 分 离 三 维特 征 ， 用 空 
射 算 法 ， 通过 x 射 
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一 些 技 术 ， 如 采 




















hh pod um 








Westermann 在 该 主题 上 的 开创 性 论文 上 )。 





11.1.1 数据 格式 


本 项 目 将 使 有 
描 医 学 数据 “。 
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该 档案 提供 
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顾 第 9 章 ，OpenGL 中 的 二 





了 一 些 极 


化 技术 以 提高 速度 ， 
线 投射 合成 最 终 图 像 (我 的 实现 ， 





好 的 三 维 














= 


主要 





日 来 自 斯 坦 福 体 数据 档案 (Stanford Volume Data Archive) 的 三 维 扫 
医学 数据 集 的 TIFF 
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成 一 个 长 方 体 ， 如 


坐标 Cs, O 定位 的 。 
(s，t，p)。 如 你 所 见 ， 将 体 数 据 保存 为 
光线 投射 方案 所 需 的 插值 。 





图 11-1 


类 似 





CD J. Kruger and R. Westermann, “Acceleration Techniques for GPU-based Volume Rendering,” IEEE Visualization, 2003. 
© http://graphics.stanford.edu/data/voldata/ 
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4 三 维 物体 
i 
e 


11-1 从 二 维 切 片 建立 三 维 立体 数据 


11.1.2 ”生成 光线 

该 项 目的 目标 是 生成 三 维 体 数 据 的 透视 投影 ， 如 图 11-2 所 示 。 
图 11-2 展示 了 OpenGL 视 锥 ， 这 在 第 9 章 讨 论 过 。 有 具体 来 说 ， 它 展示 了 来 自 眼 
崩 的 光线 如 何 从 近 裁 剪 平 面 进入 此 锥 体 ， 通 过 立方 状 的 物体 〈 其 中 包含 体 数据 )， 
并 从 后 面 的 远 裁剪 平面 出 去 。 
























































立方 体 的 光线 出 口 
远 栽 剪 平面 
立方 体 的 光线 入 口 








近 栽 剪 平面 〈 输 出 窗口 ) 


11-2 ”三维 体 数 据 透 视 投影 
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为 了 实现 光线 投射 ， 需 要 生成 进入 物体 的 光线 。 对 于 图 11-2 所 示 的 输出 窗口 中 的 
每 个 像素 ， 生 成 一 个 向 量 R， 它 进入 我 们 作为 单位 立方 体 的 物体 中 我 称 之 为 彩色 立 
方 体 )， 该 立方 体 在 坐标 (0，0，0) 和 CI, 1, D 之 间 。 这 个 立方 体 中 的 每 个 点 的 颜 
色 ， 其 RGB 值 等 于 它 的 三 维 坐 标 。 原 点 颜色 为 (0，0，0)， 即 黑色 。(1，0，0) 角 是 
红色 ， 与 原点 相对 的 顶点 颜色 为 (1，1，1)， 即 白色 。 图 11-3 展示 了 这 个 立方 体 。 












































1.3 彩色 立方 体 





E 


在 OpenGL 中 ， 颜 色 可 以 表示 为 一 事 8 位 无 符号 值 (tr, g, bl)， 其 中 r、g 和 
的 范围 是 [0，255]。 它 也 可 以 表示 为 32 位 的 浮 点 值 (r, g,b)， 其 中 Tr、g 和 b 的 范 
围 是 [0.0，1.0]。 这 些 表示 是 等 效 的 。 例 如 ， 前 一 种 的 红色 (255, 0, 0) 等 同 于 
ka —# 4) (1.0, 0.0, 0.0). 


EÈ 









































要 绘制 立方 体 ， 先 用 OpenGL 图 元 GL_TRIANGLES 绘制 它 的 6 个 面 。 然 后 确 
定 每 个 顶点 的 颜色 ， 并 在 多 边 形 光栅 化 、 生 成 顶点 之 间 的 颜色 时 ， 利 用 OpenGL 提 
供 的 插值 。 例 如 ， 如 图 11-4 CAO 展示 了 立方 体 的 三 个 正面 。 图 11-4 (B) 将 OpenGL 
设置 为 剔除 正面 ， 绘 制 了 立方 体 的 背 
如 果 从 图 11-4 CB) FREE 11-4 CAD 中 的 颜色 ， ENM C, g, b)back 减 去 (1, g, 
b)front， 实 际 上 计算 了 一 组 向 量 ， 从 立方 体 的 正面 指向 背面 ， 因 为 该 立方 体 上 每 
点 的 颜色 (r, g. 日 与 三 维 坐标 相同 。 图 11.4 COO RATAR ITER, MEE 
经 翻转 为 正 ， 因 为 负数 不 能 直接 显示 为 颜色 )。 读 取 一 个 像素 的 颜色 值 (Cg, b), 
如 图 11-4 (C) 所 示 ， 得 到 (rx, ry rz) 坐标 ， 即 在 这 一 点 穿 透 物 体 的 光线 。 
有 了 投射 光线 后 ， 将 它们 泻 染 成 一 张 图 或 二 维 纹理 ， 稍 后 与 OpenGL 的 帧 缓冲 
对 象 (FBO) 功能 一 起 使 用 。 产生 这 个 纹理 之 后 ， 可 以 在 实现 光线 投射 算法 的 着 色 

器 内 访问 它 。 
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11-4 用 于 计算 光线 的 颜色 立方 体 
GPU 中 的 光线 投射 




















为 了 实现 光线 投射 算法 ， 首 先 将 彩色 立方 体 的 背面 绘制 到 FBO。 接 着 ， 将 正面 
绘制 在 屏幕 上 。 光线 投 射 算法 的 主要 部 分 发 生 在 片段 着 色 器 中 , 进行 这 种 二 次 泻 染 ， 
针对 输出 的 每 个 像素 进行 。 光 线 的 计算 是 用 颜色 立方 体 的 背面 颜色 减 去 传 入 片段 的 
正面 颜色 ， 背 面 颜色 是 从 纹理 中 读 取 的 。 然 后 将 计算 好 的 光线 累加 ， 并 利用 着 色 器 
中 可 用 的 三 维 体 纹理 数据 ， 计 算 最 终 的 像素 值 。 


SAR 
在 OpenGL 中 ， 如 果 要 画 四 边 形 这 样 的 图 元 ， 指 定 顶 点 的 顺序 很 重要 。 默 认 情 
ILF, OpenGL 假定 用 GL CCW ( 逆 时 针 ) 的 顺序 。 对 于 逆 时 针 顺序 的 图 元 ， 法 夭 
量 将 指向 多 边 形 的 “外 面 "。 如 果 试 图 绘制 封闭 区 域 的 几何 图 形 ， 如 立方 体 ， 这 就 有 
关系 了 。 为 了 优化 泻 染 ， 你 不 用 绘制 看 不 见 的 面 ， 只 要 打开 OpenGL 的 “背面 别 除 
( back-face culling ,计算 观 看 方向 向 量 与 多 边 形 法 向 量 的 点 积 。 对 于 朝向 背面 的 多 
























































































































































的 事 ， 即 正面 剔除 ， 这 就 是 我 们 在 算法 要 用 到 的 。 
显示 二 维 切片 
除了 三 维 泻 染 ， 也 可 以 显示 数据 的 二 维 切 片 ， 做 法 是 从 三 维 数据 中 提取 垂直 于 
x 轴 、y 轴 或 z 轴 的 二 维 横 截 面 ， 并 将 它 作为 一 个 四 边 形 的 纹理 。 因 为 我 们 将 物体 
保存 为 三 维 纹理 ， 所 以 很 容易 通过 指定 纹理 坐标 Cs, t, p) 得 到 所 需 的 数据 。OpenGL 
内 置 的 纹理 插值 可 以 给 出 三 维 纹理 内 任意 位 置 的 纹理 值 。 

















































































































































































































11.1.3 显示 OpenGL 窗口 

像 其 他 OpenGL 项 目 一 样 ,本 项 目 用 GLEW 库 来 显示 OpenGL 窗口 。 我 们 用 处 
理 程序 来 绘制 ， 响 应 调整 窗口 大 小 和 键盘 事件 。 我 们 将 利用 键盘 事件 在 体 泻 染 和 切 
片 泻 染 之 间 切 换 ， 以 及 实现 穿 过 三 维 数据 的 旋转 和 切片 。 
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11.2 ”所 需 模 块 






































我 们 用 PyOpenGL 进行 泻 染 ， 











numpy 数组 来 表示 三 维 坐标 和 变换 矩阵 。 











11.3 项 目 代 码 概 述 











我 们 首先 从 体 数 据 生成 三 维 纹理 ， 











然后 ， 我 们 将 探索 体积 光线 投射 

















将 学 习 如 何 实现 体 数据 的 二 维 切片 。 


该 项 目 有 7 个 Python 文件 : 
glutils.py 包含 针对 OpenGL 着 色 器 
makedata.py 包含 创建 测试 体 数据 的 工具 方法 ; 
raycast.py 实现 了 RayCastRender 类 ， 
raycube.py 实现 了 RayCastRender 上 











它 是 流行 的 OpenGL 的 Python 绑 定 。 我 们 还 用 


、 转 换 和 其 他 相关 工具 方法 ; 




















数据 是 从 文件 读 入 的 。 接 下 来 ， 我 们 分 析 颜 
色 立 方 体 技术 ， 用 于 生成 从 眼睛 指向 物体 的 光线 ， 这 是 实现 体 光 线 投射 算法 的 关键 
概念 。 我 们 将 分 析 如 何 定义 立方 体 的 几 体形 状 ， 如 何 绘制 该 立方 体 的 背面 和 正面 。 
算法 ， 以 及 相关 的 顶点 和 片段 着 色 器 。 最 后 ， 我 们 



















































































于 光线 投射 


























使 用 的 RayCube 25; 





slicerender.py 实现 了 SliceRender 类 ， 用 于 体 数 据 的 二 维 切 片 ; 





volreader.py 包含 一 个 工具 方法 ， 读 取 体 数据 作为 OpenGL 的 三 维 纹理 ; 
volrender.py 包含 用 于 创建 GLFW 窗口 和 泻 染 器 的 主要 方法 。 
除了 两 个 文件 之 外 ， 本 章 将 介绍 所 有 这 些 文件 。 文 件 makedata.py 和 本 章 中 的 




























































































其 他 项 目 文件 一 起 放 在 https://github.com/electronut/pp/tree/master/volrender/。 文 件 
glutils.py 可 以 从 https://github.com/electronut/pp/tree/master/common/ F £X o 


11.4 生成 三 维 纹理 











volreader.py 的 完整 代码 ,i 


def loadVolume(dirName): 


第 一 步 是 从 包含 图 像 的 文件 来 
青 直 接 跳 到 11.5 节 












































读 取 体 数据 ， 如 下 面 代码 所 示 。 要 查看 





























""read volume from directory as a 3D texture""" 

# list images in directory 
o files = sorted(os.listdir(dirName)) 
print('loading images from: %s' *s dirName) 


imgDataList = [] 
count = 0 

width, height = 0, 0 
for file in files: 


e file path = os.path.abspath(os.path.join(dirName, file)) 


try: 
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# read image 
img = Image.open(file_path) 
imgData = np.array(img.getdata(), np.uint8) 


# check if all images are of the same size 
if count is 0: 
width, height = img.size[0], img.size[1] 
imgDataList.append(imgData) 
else: 
if (width, height) == (img.size[0], img.size[1]): 
imgDataList.append(imgData) 
else: 
print( ‘mismatch’ ) 
raise RunTimeError("image size mismatch") 


count *- 1 

#print img.size 
except: 

# skip 


print('Invalid image: %s' % file path) 


# load image data into single array 

depth = count 

data = np.concatenate(imgDataList) 

print('volume data dims: %d %d %d' % (width, height, depth) ) 


# load data into 3D texture 
texture = glGenTextures(1) 
glPixelStorei(GL UNPACK ALIGNMENT, 1) 
giBindTexture(GL TEXTURE 3D, texture) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP S, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP T, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP R, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE MAG FILTER, GL LINEAR) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE MIN FILTER, GL LINEAR) 
glTexImage3D(GL TEXTURE 3D, 0, GL RED, 

width, height, depth, O, 

GL RED, GL UNSIGNED BYTE, data) 
# return texture 
return (texture, width, height, depth) 


loadVolume0 7; iX 45 H] os 模块 中 的 listdirO0 方 法 ， 列 出 了 给 定 目 录 中 的 文 
Fo. 然后 加 载 图 像 文件 本 身 。 在 @ 行 , 利用 os.path.abspath() 和 os.path.join()， 
将 文件 名 添加 到 目录 ， 从 而 不 必 处 理 相 对 文件 路 径 和 操作 系统 (OS) 特定 的 
路 径 约 定 (Python 代码 中 经 常 可 以 看 到 这 个 有 用 的 习惯 用 法 ， 用 于 遍历 文件 
和 目录 )。 
在 @ 行 , 利用 Python 图 像 库 (PIL) 中 的 Image X, 将 图 像 加 载 到 8 位 的 numpy 
数组 。 如 果 指 定 的 文件 不 是 图 像 或 图 像 加 载 失 败 ， 则 抛 出 一 个 异常 ， 我 们 捕获 它 并 
打印 错误 。 

因为 要 将 这 些 图 像 加 载 成 为 三 维 纹理 ， 所 以 需要 确保 它们 都 具有 相同 的 尺寸 
( 宽 X 高 )， 这 在 @ 和 @ 行 确认 。 保 存 第 一 张 图 像 的 尺寸 ， 并 与 新 传 入 的 图 像 进行 比 
较 。 所 有 图 像 加 载 为 单独 的 数组 后 ， 利 用 numpy 的 concatenate() 方 法 ， 将 这 些 数组 
连接 起 来 ， 创 建 包 含 三 维 数据 的 最 终 数组 @。 
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在 @ 行 和 接 下 来 几 行 中 , 创建 了 OpenGL 纹理 , 并 针对 过 滤 和 拆 包 设置 了 参数 。 
然后 , EO, 将 三 维 数据 数组 加 载 为 OpenGL 纹理 。 这 里 使 用 的 格式 是 GL_RED， 
数据 格式 是 GL_UNSIGNED_BYTE, 因为 在 数据 中 , 我 们 只 有 一 个 8 位 值 与 每 个 像 
素 相 关联 。 

最 后 ， 在 @ 行 ， 返 回 了 OpenGL 纹理 ID 和 三 维 纹理 的 尺寸 。 





























































































































11.5 ”完整 的 三 维 纹理 代码 


下 面 是 完整 的 代码 清单 。 可 以 在 https:// github.com/electronut/pp/tree/master/ 
volrender/ 找 到 volreader.py 文件 。 














T 


import os 
import numpy as np 
from PIL import Image 


import OpenGL 
from OpenGL.GL import * 


from scipy import misc 


def loadVolume(dirName): 
"""read volume from directory as a 3D texture""" 
# list images in directory 
files = sorted(os.listdir(dirName)) 
print('loading images from: %s' *s dirName) 
imgDataList - [] 
count = 0 
width, height = 0, 0 
for file in files: 
file path = os.path.abspath(os.path.join(dirName, file) ) 
try: 
# read image 
img = Image.open(file_path) 
imgData = np.array(img.getdata(), np.uint8) 


# check if all are of the same size 
if count is 0: 
width, height = img.size[0], img.size[1] 
imgDataList.append(imgData) 
else: 
if (width, height) == (img.size[0], img.size[1]): 
imgDataList.append(imgData) 
else: 
print('mismatch') 
raise RunTimeError("image size mismatch") 


count *- 1 

#print img.size 
except: 

# skip 


print('Invalid image: %s' % file_path) 
# load image data into single array 


depth = count 
data = np.concatenate(imgDataList) 
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print('volume data dims: %d %d %d' % (width, height, depth) ) 


# load data into 3D texture 
texture = glGenTextures(1) 
glPixelStorei(GL UNPACK ALIGNMENT, 1) 
glBindTexture(GL TEXTURE 3D, texture) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP S, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP T, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE WRAP R, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE MAG FILTER, GL LINEAR) 
glTexParameterf(GL TEXTURE 3D, GL TEXTURE MIN FILTER, GL LINEAR) 
glTexImage3D(GL TEXTURE 3D, O, GL RED, 

width, height, depth, O, 

GL RED, GL UNSIGNED BYTE, data) 
#return texture 
return (texture, width, height, depth) 




















# load texture 

def loadTexture(filename): 
img - Image.open(filename) 
img data - np.array(list(img.getdata()), 'B') 
texture = glGenTextures(1) 
glPixelStorei(GL_UNPACK_ALIGNMENT, 1) 
glBindTexture(GL TEXTURE 2D, texture) 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE WRAP S, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE WRAP T, GL CLAMP TO EDGE) 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE MAG FILTER, GL LINEAR) 
glTexParameterf(GL TEXTURE 2D, GL TEXTURE MIN FILTER, GL LINEAR) 
glTexlImage2D(GL TEXTURE 2D, 0, GL RGBA, img.size[0], img.size[1], 

0, GL RGBA, GL UNSIGNED BYTE, img data) 

return texture 

















11.6 生成 光线 


生成 光线 的 代码 封装 在 RayCube 类 中 。 该 类 负责 绘制 彩色 立方 体 ， 它 有 一 些 方 
去 将 立方 体 的 背面 绘制 到 FBO 或 纹理 中 ， 并 将 立方 体 的 正面 绘制 到 屏幕 上 。 要 得 
看 完整 的 raycube.py 代码 ， 请 直接 跳 到 11.7 节 

首先 ， 定 义 这 个 类 使 用 的 着 色 器 


© strvs = """ 
#version 330 core 












































一 < 









































layout(location = 1) in vec3 cubePos; 
layout(location = 2) in vec3 cubeCol; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 
out vec4 vColor; 


void main() 


// set back-face color 
vColor = vec4(cubeCol.rgb, 1.0); 
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// transformed position 
vec4 newPos = vec4(cubePos.xyz, 1.0); 


// set position 
gl Position = uPMatrix * uMVMatrix * newPos; 


@ strFS = """ 
#version 330 core 


in vec4 vColor; 
out vec4 fragColor; 


void main() 
{ 
fragColor = vColor; 


} 














在 @ 行 ， 定 义 了 RayCube 类 使 用 的 顶点 着 色 器 。 该 着 色 器 有 两 个 输入 属性 : 
cubePos 和 cubeCol， 它 们 分 别 用 于 访问 顶点 的 位 置 和 颜色 的 值 。 模 型 视图 和 投影 
车 分 别 通过 uniform 变量 uMVMatrix 和 pMatrix 传 入 。vColor 变量 声明 为 输出 ， 因 
为 它 需要 传 入 片段 着 色 器 ， 在 那里 进行 插值 。 在 @ 行 实现 的 片段 着 色 器 ， 将 片段 颜 
色 设 置 为 传 入 的 vColor( 插 值 后 的 ) 值 ，vColor 在 顶点 着 色 器 中 设置 。 






















































































11.6.1 定义 颜色 立方 体 的 几何 形状 
现在 ， 看 看 颜色 立方 体 的 几何 形状 ， 它 在 RayCube 类 中 定义 : 


# cube vertices 














o vertices - numpy.array([ 
0.0, 0.0, 0.0, 
1.0, 0.0, 0.0, 
1.0, 1.0, 0.0, 
0.0, 1.0, 0.0, 
0.0, 0.0, 1.0, 
1.0, 0.0, 1.0, 
1.0, 1.0, 1.0, 
0.0, 1.0, 1.0 
], numpy.float32) 


# cube colors 


@ colors = numpy.array([ 
0.0, 0.0, 0.0, 
1.0, 0.0, 0.0, 
1.0, 1.0, 0.0, 
0.0, 1.0, 0.0, 
0.0, 0.0, 1.0, 
1.0, 0.0, 1.0, 
1.0, 1.0, 1.0, 
0.0, 1.0, 1.0 
], numpy.float32) 


# individual triangles 
e indices = numpy.array([ 
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mpy.int16) 


在 RayCube 的 构造 函数 中 ， 汇 集 了 着 色 器 ， 并 创建 了 program 对 象 。 在 @ 行 定 
义 了 立方 体 的 几何 形状 ，@ 行 定义 了 颜色 。 

颜色 立方 体 有 6 个 面 ， 每 个 面 可 以 绘制 成 两 个 三 角形 ， 总 共有 6X6 Go 个 项 
点 。 但 是 ， 我 们 不 是 指定 所 有 36 个 顶点 ， 而 是 指定 立方 体 的 8 个 顶点 ， 然 后 用 一 
个 indices 数组 定义 一 些 三 角形 ， 如 @@ 行 和 图 11-5 所 示 。 




































































X 


11-5 ”利用 索引 ， 一 个 立方 体 可 以 表示 为 三 角形 的 集合 ， 每 个 面 由 两 个 三 角形 组 成 


接 下 来 ， 需 要 将 顶点 信息 放 入 缓冲 区 。 


# set up vertex array object (VAO) 
self.vao = glGenVertexArrays(1) 
glBindVertexArray(self.vao) 


# vertex buffer 
self.vertexBuffer = glGenBuffers(1) 
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glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(vertices), vertices, GL STATIC DRAW) 


# vertex buffer — cube vertex colors 

self.colorBuffer - glGenBuffers(1) 

glBindBuffer(GL ARRAY BUFFER, self.colorBuffer) 
giBufferData(GL ARRAY BUFFER, 4*len(colors), colors, GL STATIC DRAW) 


# index buffer 
self.indexBuffer = glGenBuffers(1) 
o giBindBuffer(GL ELEMENT ARRAY BUFFER, self.indexBuffer) 
glBufferData(GL ELEMENT ARRAY BUFFER, 2*len(indices), indices, 
GL STATIC DRAW) 
象 以 往 的 项 目 一 样 ， 我 们 可 以 创建 并 绑 定 到 一 个 顶点 数组 对 象 《VAO )， 然 后 定 

义 它 管理 的 缓冲 区 。 这 里 有 一 个 区 别 : 在 @ 行 ，indices 数组 设 定 为 GL_ELEMENT_ 
ARRAY_BUFFER， 这 意味 着 它 的 缓冲 器 中 的 元 素 将 用 来 索引 和 访问 颜色 和 顶点 组 
冲 器 中 的 数据 。 













































































11.6.2 ”创建 帧 缓冲 区 对 象 
现在 ， 让 我 们 跳 到 创建 


def initFBO(self): 
# create frame buffer object 
self .fboHandle = glGenFramebuffers(1) 
# create texture 
self.texHandle = glGenTextures(1) 
# create depth buffer 
self.depthHandle = glGenRenderbuffers(1) 


























区 对 象 的 方法 ， 在 该 方法 中 将 进行 泻 染 。 
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# bind 
glBindFramebuffer(GL_FRAMEBUFFER, self.fboHandle) 


glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texHandle) 


# set parameters to draw the image at different sizes 

o glTexParameteri(GL TEXTURE 2D, GL TEXTURE MIN FILTER, GL LINEAR) 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE MAG FILTER, GL LINEAR) 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP S, GL CLAMP TO EDGE) 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP T, GL CLAMP TO EDGE) 
# set up texture 
glTexlImage2D(GL TEXTURE 2D, 0, GL RGBA, self.width, self.height, 

0, GL RGBA, GL UNSIGNED BYTE, None) 

















# bind texture to FBO 
e glFramebufferTexture2D(GL FRAMEBUFFER, GL COLOR ATTACHMENTO, 
GL TEXTURE 2D, self.texHandle, 0) 


# bind 
e giBindRenderbuffer(GL RENDERBUFFER, self.depthHandle) 
glRenderbufferStorage(GL RENDERBUFFER, GL DEPTH COMPONENT24, 
self.width, self.height) 


# bind depth buffer to FBO 
glFramebufferRenderbuffer(GL FRAMEBUFFER, GL DEPTH ATTACHMENT, 
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11.6.4 


GL_RENDERBUFFER, self.depthHandle) 


# check status 


o status - glCheckFramebufferStatus(GL FRAMEBUFFER) 


if status -- GL FRAMEBUFFER COMPLETE: 

pass 

#print "fbo *sd complete" % self.fboHandle 
elif status -- GL FRAMEBUFFER UNSUPPORTED: 

print "fbo %d unsupported" % self.fboHandle 
else: 

print "fbo %d Error" % self.fboHandle 


















































这 里 ， 我 们 创建 帧 缓冲 区 对 象 、 二 维 纹理 和 泻 染 缓冲 区 对 象 。 然 后 在 @ 行 ， 寻 


Tar 

















并 了 纹理 参数 。 在 @ 行 ， 纹 理 绑 定 到 帧 缓冲 区 对 象 。 在 @ 行 和 随后 的 几 行 中 ， 泻 染 
h 区 对 象 。 在 @ 行 ,检查 帧 组 

















缓冲 区 设置 了 一 个 24 位 的 深度 缓冲 区 ， 并 连接 到 帧 缓 六 
冲 区 的 状态 ， 如 果 出 现 错误 则 打印 状态 信息 。 现 在 ， 只 
定 正 确 ， 所 有 的 泻 染 将 进入 纹理 
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泻 染 立方 体 的 背面 








下 面 的 代码 泻 染 了 颜色 立方 体 的 背 


def renderBackFace(self, pMatrix, mvMatrix): 
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P DCRITE E ZEE X 


"""renders back-face of ray-cube to a texture and returns it""" 


# render to FBO 


o giBindFramebuffer(GL FRAMEBUFFER, self.fboHandle) 


# set active texture 

glActiveTexture(GL TEXTUREO) 

# bind to FBO texture 
glBindTexture(GL TEXTURE 2D, self.texHandle) 


# render cube with face culling enabled 


# unbind texture 


e giBindTexture(GL TEXTURE 2D, 0) 


glBindFramebuffer(GL FRAMEBUFFER, 0) 
giBindRenderbuffer(GL RENDERBUFFER, 0) 


# return texture ID 


o return self.texHandle 


self.renderCube(pMatrix, mvMatrix, self.program, True) 












































在 @ 行 ， 绑 定 FBO， 设 置 活动 纹理 单元 ， 并 绑 定 到 


























纹理 处 至 


程序 ， 这 样 就 可 以 














泻 染 到 FBO。 在 @ 行 ， 调 用 RayCube 的 renderCube0 方 法 ， 以 一 个 面 剔除 标志 为 参 






































数 ， 以 便 用 同样 的 代码 来 绘制 立方 体 的 正面 或 背面 。 该 标志 设置 为 tue， 让 背面 出 


























现在 FBO 纹理 中 。 在 @ 行 ， 进 行 必 要 的 调用 ， 解 除 FBO 绑 定 ， 这 样 其 他 演 染 代码 
将 不 受 影响 。 在 @ 行 返回 FBO 纹理 ID ， 用 于 算法 的 下 一 阶段 。 






































泻 染 立方 体 的 正面 











以 下 代码 在 光线 投射 算法 的 第 二 遍 泻 染 时 ， 绘 制 颜色 立方 体 的 正面 。 它 就 调用 
























































了 11.6.3 小 节 中 讨论 的 renderCube0 方 法 ， 只 是 面 剔除 标志 设置 为 False。 
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def renderFrontFace(self, pMatrix, mvMatrix, program): 
"""render front-face of ray-cube""" 
# no face culling 
self.renderCube(pMatrix, mvMatrix, program, False) 


11.6.5 ” 泻 染 整个 立方 体 
现在 看 一 下 renderCube(0 方 法 ， 它 绘制 前 面 讨论 过 的 彩色 立方 体 : 


def renderCube(self, pMatrix, mvMatrix, program, cullFace): 
"""renderCube uses face culling if flag set""" 


























glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 





# set shader program 
glUseProgram (program) 


# set projection matrix 
glUniformMatrix4fv(glGetUniformLocation(program, b'uPMatrix'), 
1, GL_FALSE, pMatrix) 


# set modelview matrix 
glUniformMatrix4fv(glGetUniformLocation(program, b'uMVMatrix'), 
1, GL FALSE, mvMatrix) 


# enable face culling 
glDisable(GL CULL FACE) 


o if cullFace: 
glFrontFace(GL_CCW) 
giCullFace(GL FRONT) 
giEnable(GL CULL FACE) 


# bind VAO 
glBindVertexArray(self.vao) 


# animated slice 
e glDrawElements(GL TRIANGLES, self.nIndices, GL UNSIGNED SHORT, None) 


# unbind VAO 
glBindVertexArray (0) 


# reset cull face 

if cullFace: 
# disable face culling 
glDisable(GL CULL FACE) 


在 这 个 列表 中 可 以 看 到 , 我 们 清除 了 颜色 和 深度 缓冲 区 , 然后 选择 着 色 器 程序 ， 
设置 了 变换 矩阵 。 在 @ 行 ， 设 置 了 一 个 标志 ， 控 制 面 剔除 ， 这 就 决定 了 绘制 立方 体 
的 正面 或 背面 。 而 且 ， 我 们 使 用 了 glDrawElements()@， 因 为 要 用 一 个 索引 数组 来 
宜 染 立方 体 ， 而 不 是 一 个 项 点数 组。 
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11.6.6 ”调整 大 小 处 理 程序 
由 于 FBO ding da 上 建 的 ， 所 以 窗口 大 小 发 生变 化 时 ， 需 要 重新 
创建 它 。 要 做 到 这 一 点 ， 可 以 为 RayCube 类 创建 调整 大 小 的 处 理 程序 ， 如 下 所 示 : 


o def reshape(self, width, height): 
self.width - width 
self.height - height 
self.aspect = width/float(height) 
# re-create FBO 
self .clearFBO() 
self .initFBO() 


H OpenGL 窗口 的 大 小 时 ， 
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] Y reshape0) 函 数 @。 


11.7 完整 的 光线 生成 代码 


以 下 是 完整 的 代码 清单 。 也 可 以 https://github.com/electronut/pp/tree/master/ 
volrender/ 找 到 raycube.py 文件 。 


import OpenGL 
from OpenGL.GL import * 
from OpenGL.GL.shaders import * 








import numpy, math, sys 
import volreader, glutils 


StrVS = """ 
#version 330 core 


layout (location 
layout (location 


= 1) in vec3 cubePos; 
= 2) in vec3 cubeCol; 
uniform mat4 uMVMatrix; 

uniform mat4 uPMatrix; 

out vec4 vColor; 


void main() 


{ 
// set back face color 
vColor = vec4(cubeCol.rgb, 1.0); 


// transformed position 
vec4 newPos = vec4(cubePos.xyz, 1.0); 


// set position 
gl Position = uPMatrix * uMVMatrix * newPos; 


} 


StrFS = """ 
#version 330 core 


in vec4 vColor; 
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out vec4 fragColor; 


void main() 
{ 


fragColor = vColor; 


} 


class RayCube: 
"""class used to generate rays used in ray casting""" 


def _ init__(self, width, height): 
"""RayCube constructor""" 


# set dims 
self.width, self.height = width, height 


# create shader 
self.program = glutils.loadShaders(strVS, strFS) 


# cube vertices 
vertices = numpy.array([ 
0.0, 0.0, 


3 


=00-=o0 


T5 
, nump 


3 


0 
1 0, 0 
1 0,0 
0 0, 0 
0. 70. 
1 O0, 1 
1 O0, 1 
0 0, 1 
] y.fl 
# cube colors 

colors = numpy.array([ 


, 0. 


了 


, 


一 口 口 一 一 口 口 


0 
1 0 
1 0，0 
0 0,0 
0. 0, 1. 
1 .0, 1 
1 Qs 
0.0, 1.0, 1 
] y.fl 
# individual triangles 
indices = numpy.array([ 


5，7， 


AARNDWBONA DANA I 
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def 


], numpy.int16) 
self.nIndices = indices.size 


# set up vertex array object (VAO) 
self.vao = glGenVertexArrays(1) 
glBindVertexArray (self .vao) 


#vertex buffer 

self.vertexBuffer = glGenBuffers(1) 

gliBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(vertices), vertices, GL STATIC DRAW) 


# vertex buffer - cube vertex colors 

self.colorBuffer = glGenBuffers(1) 

g1BindBuffer(GL_ARRAY_BUFFER, self.colorBuffer) 
glBufferData(GL_ARRAY_BUFFER, 4*len(colors), colors, GL STATIC DRAW); 


# index buffer 

self.indexBuffer = glGenBuffers(1) 

giBindBuffer(GL ELEMENT ARRAY BUFFER, self.indexBuffer) 

glBufferData(GL ELEMENT ARRAY BUFFER, 2*len(indices), indices, 
GL STATIC DRAW) 


# enable attrs using the layout indices in shader 
aPosLoc = 1 
aColorLoc = 2 


# bind buffers: 
glEnableVertexAttribArray (1) 
glEnableVertexAttribArray (2) 


# vertex 
glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glVertexAttribPointer(aPosLoc, 3, GL FLOAT, GL FALSE, 0, None) 


# color 

giBindBuffer(GL ARRAY BUFFER, self.colorBuffer) 
glVertexAttribPointer(aColorLoc, 3, GL FLOAT, GL FALSE, O, None) 
# index 

glBindBuffer(GL ELEMENT ARRAY BUFFER, self .indexBuffer) 


# unbind VAO 
glBindVertexArray (0) 


# FBO 
self .initFBO() 


renderBackFace(self, pMatrix, mvMatrix): 

"""renders back-face of ray-cube to a texture and returns it""" 
# render to FBO 

g1BindFramebuffer(GL_FRAMEBUFFER, self .fboHandle) 

# set active texture 

glActiveTexture(GL TEXTUREO) 

# bind to FBO texture 

glBindTexture(GL TEXTURE 2D, self.texHandle) 


# render cube with face culling enabled 
self.renderCube(pMatrix, mvMatrix, self.program, True) 
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# unbind texture 
glBindTexture(GL_TEXTURE_2D, 0) 
gliBindFramebuffer(GL FRAMEBUFFER, 0) 
glBindRenderbuffer(GL RENDERBUFFER, 0) 


# return texture ID 
return self.texHandle 


def renderFrontFace(self, pMatrix, mvMatrix, program): 
"""render front face of ray-cube""" 
# no face culling 
self.renderCube(pMatrix, mvMatrix, program, False) 


def renderCube(self, pMatrix, mvMatrix, program, cullFace): 
"""render cube use face culling if flag set'"" 


glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
# set shader program 
glUseProgram (program) 





# set projection matrix 
glUniformMatrix4fv(glGetUniformLocation(program, b'uPMatrix'), 
1, GL_FALSE, pMatrix) 


# set modelview matrix 
glUniformMatrix4fv(glGetUniformLocation(program, b'uMVMatrix'), 
1, GL_FALSE, mvMatrix) 


# enable face culling 

glDisable(GL CULL FACE) 

if cullFace: 
giFrontFace(GL CCW) 
glCullFace(GL FRONT) 
glEnable(GL CULL FACE) 


# bind VAO 
giBindVertexArray(self.vao) 


# animated slice 
glDrawElements(GL_TRIANGLES, self.nIndices, GL UNSIGNED SHORT, None) 


# unbind VAO 
glBindVertexArray (0) 


# reset cull face 

if cullFace: 
# disable face culling 
glDisable(GL CULL FACE) 


def reshape(self, width, height): 
self.width - width 
self.height - height 
self.aspect - width/float(height) 
# re-create FBO 
self .clearFBO() 
self .initFBO() 


def initFBO(self): 
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def 


# create frame buffer object 

self .fboHandle = glGenFramebuffers(1) 

# create texture 

self.texHandle = glGenTextures(1) 

# create depth buffer 

self.depthHandle = glGenRenderbuffers(1) 


# bind 
giBindFramebuffer(GL FRAMEBUFFER, self .fboHandle) 


glActiveTexture(GL TEXTUREO) 
glBindTexture(GL TEXTURE 2D, self.texHandle) 


# set parameters to draw the image at different sizes 
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR) 
glTexParameteri(GL_TEXTURE_2D, GL TEXTURE MAG FILTER, GL LINEAR) 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP S, GL CLAMP TO EDGE) 
glTexParameteri(GL TEXTURE 2D, GL TEXTURE WRAP T, GL CLAMP TO EDGE) 














# set up texture 
glTexlImage2D(GL TEXTURE 2D, 0, GL RGBA, self.width, self.height, 
0, GL RGBA, GL UNSIGNED BYTE, None) 





# bind texture to FBO 
giFramebufferTexture2D(GL FRAMEBUFFER, GL COLOR ATTACHMENTO, 
GL TEXTURE 2D, self.texHandle, 0) 


# bind 

giBindRenderbuffer(GL RENDERBUFFER, self.depthHandle) 

glRenderbufferStorage(GL RENDERBUFFER, GL DEPTH COMPONENT24, 
self.width, self.height) 


# bind depth buffer to FBO 
giFramebufferRenderbuffer(GL FRAMEBUFFER, GL DEPTH ATTACHMENT, 
GL RENDERBUFFER, self.depthHandle) 


# check status 
status = glCheckFramebufferStatus (GL_FRAMEBUFFER) 
if status == GL_FRAMEBUFFER_COMPLETE: 

pass 

#print "fbo %d complete" % self.fboHandle 
elif status == GL_FRAMEBUFFER_UNSUPPORTED: 

print("fbo %d unsupported" % self.fboHandle) 
else: 

print("fbo %d Error" % self.fboHandle) 


giBindTexture(GL TEXTURE 2D, 0) 
giBindFramebuffer(GL FRAMEBUFFER, 0) 
giBindRenderbuffer(GL RENDERBUFFER, 0) 
return 


clearFBO(self): 

"""clears old FBO""" 

# delete FBO 

if glIsFramebuffer(self.fboHandle): 
glDeleteFramebuffers(int(self.fboHandle)) 


# delete texture 


911: (SX 


191 


if glIsTexture(self.texHandle): 
glDeleteTextures(int(self.texHandle)) 


def close(self): 
"""call this to free up OpenGL resources""" 
giBindTexture(GL TEXTURE 2D, 0) 
giBindFramebuffer(GL FRAMEBUFFER, 0) 
giBindRenderbuffer(GL RENDERBUFFER, 0) 
# delete FBO 
if glIsFramebuffer(self.fboHandle): 

giDeleteFramebuffers(int(self.fboHandle)) 


# delete texture 
if glIsTexture(self.texHandle): 
glDeleteTextures(int(self.texHandle)) 


# delete render buffer 


if glIsRenderbuffer(self.depthHandle): 


glDeleteRenderbuffers(1, int(self.depthHandle)) 


# delete buffers 

glDeleteBuffers(1, self. vertexBuffer) 
glDeleteBuffers(1, & indexBuffer) 
glDeleteBuffers(1, & colorBuffer) 


11.8 体 光 线 投 射 

















接 下 来 ， 在 RayCastRender 类 中 实现 光线 投射 算法 。 算 法 的 核心 发 生 在 该 类 使 



























































完整 代码 ， 请 直接 跳 到 11.9 节 。 
































用 的 片段 着 色 器 内 ， 该 类 也 使 用 RayCube 类 来 帮助 生成 光线 。 要 查看 raycast.py 的 























加 载 着 色 器 。 








开始 先 创建 一 个 RayCube 对 象 ， 并 在 其 构造 函数 


def | init__(self, width, height, volume): 
"""RayCastRender construction""" 


# create RayCube object 
o self.raycube = raycube.RayCube(width, height) 


# set dimensions 

self.width = width 

self.height - height 

self.aspect = width/float(height) 


# create shader 


@ self.program = glutils.loadShaders(strVS, strFS) 
# texture 
e self.texVolume, self.Nx, self.Ny, self.Nz - volume 


# initialize camera 
o self.camera - Camera() 
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在 @ 行 ， 构 造 函 数 创 建 了 一 个 RayCube 对 象 ， 用 于 生成 光线 。 在 @ 行 ， 加 载 
光线 投射 使 用 的 着 色 器 。 然 后 在 自行 ， 设 置 OpenGL 的 三 维 纹理 和 尺寸 ， 它 们 作 
为 一 个 元 组 传 入 RayCastRender 的 构造 函数 。 在 @ 行 ， 创 建 一 个 Camera 类 实例 ， 
它 将 用 于 设置 OpenGL 透视 转换 ， 从 而 进行 三 维 演 染 (这 个 类 与 第 10 章 中 使 用 的 
基本 相同 )。 

下 面 是 RayCastRender 的 泻 染 方法 : 


def draw(self): 
# build projection matrix 
pMatrix = glutils.perspective(45.0, self.aspect, 0.1, 100.0) 


























































































































# modelview matrix 
mvMatrix = glutils.lookAt(self.camera.eye, self.camera.center, 
self .camera.up) 


# render 


# generate ray-cube back-face texture 
texture = self.raycube.renderBackFace(pMatrix, mvMatrix) 


# set shader program 
glUseProgram(self.program) 


# set window dimensions 
glUniform2f(glGetUniformLocation(self.program, b"uWinDims") , 
float(self.width), float(self.height) ) 


# bind to texture unit 0, which represents back-faces of cube 
glActiveTexture(GL TEXTUREO) 

giBindTexture(GL TEXTURE 2D, texture) 
glUniform1i(glGetUniformLocation(self.program, b"texBackFaces"), 0) 


# texture unit 1: 3D volume texture 

glActiveTexture(GL_TEXTURE1 ) 

glBindTexture(GL_TEXTURE_3D, self.texVolume) 
glUniform1i(glGetUniformLocation(self.program, b"texVolume"), 1) 


# draw front-face of cubes 
self.raycube.renderFrontFace(pMatrix, mvMatrix, self.program) 


在 @ 行 , 利用 glutils.perspective0 工 具 方法 , 建立 一 个 用 于 演 染 的 透视 投影 矩阵 。 
然后 ， 在 @ 行 ， 将 当前 摄像 机 参数 设置 给 glutils.lookAt(0 方 法 . TET, ERRE 
泻 染 ， 即 利用 RayCube 的 renderBackFace0 方 法 ， 将 彩色 立方 体 的 背面 绘制 成 一 个 
纹理 〈 该 方法 也 返回 生成 的 纹理 的 ID )。 
在 @ 行 ， 为 光线 投射 算法 启用 着 色 器 。 然 后 在 @@ 行 ， 设 置 目 行 返回 的 纹理 ， 准 
备 将 它 用 于 着 色 器 程序 中 ， 作 为 纹理 单元 0。 在 @ 行 ， 设 置 从 读 入 的 体 数据 中 创建 
的 三 维 纹理 ， 作 为 纹理 单元 1， 这 样 在 着 色 器 中 就 可 以 用 这 两 个 纹理 。 最 后 ， 在 @ 
47, Hj RayCube 的 renderFrontFace() 方 法 泻 染 立方 体 的 正面 。 执 行 这 段 代 码 后 ， 
RayCastRender 着 色 器 将 作用 于 顶点 和 片段 。 
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11.8.1 顶点 着 色 器 
接 下 来 是 RayCastRender 使 用 的 着 色 器 。 先 看 看 顶点 着 色 器 : 


#version 330 core 



























































© layout(location = 1) in vec3 cubePos; 
layout(location = 2) in vec3 cubeCol; 


@ uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 


© out vec4 vColor; 


void main() 


{ 
// set position 
o gl Position - uPMatrix * uMVMatrix * vec4(cubePos.xyz, 1.0); 
// set color 
e vColor = vec4(cubeCol.rgb, 1.0); 
) 








出 | 


从 @@ 行 开始 ， 设 置 位 置 和 颜色 的 输入 变量 。 布 局 使 用 的 索引 与 RayCube 顶点 着 
色 器 中 定义 相同 , 因为 RayCastRender 使 用 该 类 中 定义 的 VBO 来 绘制 几何 形状 , 着 
色 器 中 的 位 置 必须 相 匹 配 。 在 四 行 和 随后 一 行 中 ， 定 义 输入 变换 矩阵 。 然 后 ， 在 四 
行 设置 颜色 值 ， 作 为 着 色 器 的 输出 。@ 行 是 常用 变换 ， 计 算 了 内 建 的 gl Position 输 
出 。 在 @ 行 ， 将 输出 设置 为 立方 体 顶 点 的 当前 颜色 ， 顶 点 之 间 将 进行 插值 ， 从 而 在 
片段 着 色 器 中 给 出 正确 的 颜色 。 
































































































































11.8.2 片段 着 色 器 
片段 着 色 器 是 


#version 330 core 


























去 的 核心 。 


一 < 


Iml 


ELO. CKI Y tA BONS 




















in vec4 vColor; 

uniform sampler2D texBackFaces; 
uniform sampler3D texVolume; 
uniform vec2 uWinDims; 


out vec4 fragColor; 


void main() 


{ 
// start of ray 
o vec3 start = vColor.rgb; 
// calculate texture coordinates at fragment, 
// which is a fraction of window coordinates 
e vec2 texc = gl FragCoord.xy/uWinDims.xy; 
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// get end of ray by looking up back-face color 
vec3 end = texture(texBackFaces, texc).rgb; 


// calculate ray direction 
vec3 dir = end — start; 


// normalized ray direction 
vec3 norm dir = normalize(dir); 


// the length from front to back is calculated and 
// used to terminate the ray 
float len - length(dir.xyz); 


// ray step size 
float stepSize - 0.01; 


// x-ray projection 
vec4 dst - vec4(0.0); 


// step through the ray 
for(float t = 0.0; t < len; t += stepSize) { 


// set position to end point of ray 
vec3 samplePos = start + t*norm_dir; 


// get texture value at position 
float val = texture(texVolume, samplePos).r; 
vec4 src - vec4(val); 


// set opacity 
src.a *= 0.1; 
src.rgb *- src.a; 


// blend with previous value 
dst = (1.0 - dst.a)*src + dst; 


// exit loop when alpha exceeds threshold 
if(dst.a >= 0.95) 
break; 
} 


// set fragment color 
fragColor = dst; 





片段 着 色 器 的 输入 是 立方 体 项 点 的 颜色 。 片 段 着 色 器 也 能 获取 通过 演 染 颜色 立 
方 体 生 成 的 三 维 纹理 ， 包 含 数 据 的 三 维 纹理 ， 以 及 OpenGL 窗口 的 尺寸 。 
在 片段 着 色 器 执行 时 ， 我 们 传 入 立方 体 的 正面 ， 这 样 通过 在 @ 行 查找 传 入 的 颜 
色 值 ， 会 得 到 进入 这 个 立方 体 的 光线 的 起 点 《回想 一 下 11.1.2 小 节 中 关于 立方 体 ; 
的 颜色 与 光线 方向 的 联系 的 讨论 )。 
在 @ 行 ， 计 算 屏 幕 上 的 传 入 片段 的 纹理 坐标 。 用 片段 在 窗口 坐标 中 的 位 置 除 以 
窗口 尺寸 ， 得 到 范围 在 [0,.1] 的 值 。 在 日 行 ， 利 用 该 纹理 坐标 来 查找 立方 体 的 背面 颜 
色 ， 获 得 光线 的 终点 。 
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在 @ 行 ， 计 算 光 线 方向 ， 然 后 计算 光线 的 法 向 和 长 度 ， 它 们 将 用 于 光线 投射 计 
算 。 然 后 在 @@ 行 ， 利 用 光线 的 起 点 和 方向 ， 直 到 光线 的 终点 ， 我 们 循环 通过 该 物体 。 
在 @ 行 ， 计 算 光 线 在 体 数据 中 当前 的 位 置 ， 在 @ 行 ， 查 找 这 一 点 上 的 数据 值 。 

混合 公式 给 出 X 射线 效果 ， 在 @ 和 @ 行 执行 。 我 们 结合 dst 值 和 当前 的 强度 值 
( 它 利 用 alpha 值 衰 减 )， 该 过 程 沿 光线 继续 Calpha 值 不 断 增 加 )。 

在 四 行 ， 检 查 这 个 alpha 值 ， 直 到 它 等 于 最 大 闵 值 0.95， 就 退出 循环 。 最 后 的 
结果 是 某 种 平均 的 透明 度 ， 穿 透 物 体 的 每 个 像素 ， 产 生 “ 透 视 ” 或 x 射线 效果 请 
尝试 改变 闵 值 和 alpha 衰减 ， 产 生 不 同 的 效果 )。 






































































































































11.9 ”完整 的 体 光 线 投射 代码 


以 下 是 完整 的 代码 清单 。 也 可 以 在 https:// github.com/electronut/pp/tree/master/ 
volrender/ 找 到 raycast.py 文件 。 


import OpenGL 
from OpenGL.GL import * 
from OpenGL.GL.shaders import * 








import numpy as np 
import math, sys 


import raycube, glutils, volreader 


StrVS = """ 
#version 330 core 


layout (location 
layout (location 


1) in vec3 cubePos; 
2) in vec3 cubeCol; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 


out vec4 vColor; 
void main() 


// set position 
gl Position = uPMatrix * uMVMatrix * vec4(cubePos.xyz, 1.0); 


// set color 
vColor = vec4(cubeCol.rgb, 1.0); 
j 


StrFS = """ 
#version 330 core 


in vec4 vColor; 
uniform sampler2D texBackFaces; 


uniform sampler3D texVolume; 
uniform vec2 uWinDims; 
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out vec4 fragColor; 


void main() 


{ 


// start of ray 
vec3 start = vColor.rgb; 


// calculate texture coords at fragment, 
// which is a fraction of window coords 
vec2 texc = gl_FragCoord. xy/uWinDims. xy; 


// get end of ray by looking up back-face color 
vec3 end = texture(texBackFaces, texc).rgb; 


// calculate ray direction 
vec3 dir = end - start; 


// normalized ray direction 
vec3 norm dir = normalize(dir); 


// the length from front to back is calculated and 
// used to terminate the ray 
float len - length(dir.xyz); 


// ray step size 
float stepSize - 0.01; 


// x-ray projection 
vec4 dst = vec4(0.0); 


// step through the ray 
for(float t = 0.0; t < len; t += stepSize) { 


// set position to end point of ray 
vec3 samplePos = start + t*norm_dir; 


// get texture value at position 
float val = texture(texVolume, samplePos) .r; 
vec4 src = vec4(val) ; 


// set opacity 
src.a *= 0.1; 
src.rgb *= src.a; 


// blend with previous value 
dst = (1.0 - dst.a)*src + dst; 


// exit loop when alpha exceeds threshold 
if(dst.a >= 0.95) 
break; 
} 


// set fragment color 
fragColor = dst; 


class Camera: 


"""helper class for viewing""" 
def _ init__(self): 
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self.r = 1.5 

self.theta = 0 

self.center = [0.5, 0.5, 0.5] 
self.eye = [0.5 + self.r, 0.5, 0.5] 
self.up = [0.0, 0.0, 1.0] 


def rotate(self, clockWise): 
"""rotate eye by one step""" 
if clockWise: 
self.theta = (self.theta + 5) % 360 
else: 
self.theta = (self.theta - 5) % 360 
# recalculate eye 
self.eye = [0.5 + self.r*math.cos(math.radians(self.theta)), 
0.5 + self.r*math.sin(math.radians(self.theta)) 
0.5] 


3 


class RayCastRender: 
"""class that does Ray Casting""" 


def | init (self, width, height, volume): 
"""RayCastRender constr""" 


# create RayCube object 

self.raycube - raycube.RayCube(width, height) 
# set dimensions 

self.width = width 

self.height height 

self.aspect = width/float(height) 


# create shader 

self.program = glutils.loadShaders(strVS, strFS) 

# texture 

self.texVolume, self.Nx, self.Ny, self.Nz = volume 


# initialize camera 
self.camera = Camera() 


def draw(self): 


# build projection matrix 
pMatrix = glutils.perspective(45.0, self.aspect, 0.1, 100.0) 


# modelview matrix 

mvMatrix = glutils.lookAt(self.camera.eye, self.camera.center, 
self.camera.up) 

# render 


# generate ray-cube back-face texture 
texture = self.raycube.renderBackFace(pMatrix, mvMatrix) 


# set shader program 
glUseProgram(self.program) 


# set window dimensions 
glUniform2f(glGetUniformLocation(self.program, b"uWinDims") , 
float(self.width), float(self.height) ) 


# texture unit 0, which represents back-faces of cube 
glActiveTexture(GL_TEXTUREO) 
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glBindTexture(GL_TEXTURE_2D, texture) 
glUniform1i(glGetUniformLocation(self.program, b"texBackFaces"), 0) 


# texture unit 1: 


3D volume texture 


glActiveTexture(GL_TEXTURE1 ) 
giBindTexture(GL TEXTURE 3D, self.texVolume) 


glUniform1i(glGetUniformLocation(self.program, b"texVolume"), 


# draw front face of cubes 


1) 


self.raycube.renderFrontFace(pMatrix, mvMatrix, self.program) 


#self.render(pMatrix, mvMatrix) 


def keyPressed(self, 


if key s 


key): 


self.camera.rotate(True) 


elif key -- 'r': 


self.camera.rotate(False) 


def reshape(self, width, 
self.width width 

self.height - height 
self.aspect 


self.raycube.reshape(width 


def close(self): 


self.raycube.close() 


11.10 三 维 切 片 


除了 显示 体 数 据 的 三 维 视图 

















height): 


width/float(height) 


, height) 








的 二 维 切片 。 这 段 代码 封装 在 


slicerender.py 的 完整 代码 ， 请 直 


























下 面 的 初始 化 代码 为 切片 建立 了 几何 











# Set Up vertex array obje 
self.vao glGenVertexArra 
glBindVertexArray(self.vao 


# define quad vertices 
vertexData - numpy.array([ 


# vertex buffer 
self .vertexBuffer 


， 我 们 也 想 在 屏幕 上 显示 x. y 和 z 方向 上 的 数据 
SliceRender 类 中 ， 它 创建 二 维 体 切片 。 要 查看 


























接 跳 到 11.11 节 。 
PAR: 
ct (VAO) 
ys(1) 
) 
0.0, 1.0, 0.0, 
0.0, 0.0, 0.0, 
1.0, 1.0, 0.0, 
1.0, 0.0, 0.0], numpy.float32) 


glGenBuffers(1) 


glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL STATIC DRAW) 


# enable arrays 


glEnableVertexAttribArray(self.vertIndex) 


# set buffers 


glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 
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glVertexAttribPointer(self.vertIndex, 3, GL_FLOAT, GL_FALSE, 0, None) 


# unbind VAO 
glBindVertexArray (0) 


这 段 代 码 设置 了 一 个 VAO 来 管理 






































何 形状 是 在 xy 平面 上 的 正方 










































































VBO， 像 前 几 个 例子 一 要 
(顶点 顺序 是 GL_TRIANGLE_STRIP 的 顺序 ， 第 9 
































fF。 在 @ 行 定义 的 几 


章 介 绍 过 )， 所 以 无 论 是 否 显示 垂直 于 x、y 或 z 的 切片 ， 都 使 用 相同 的 几何 形状 。 
这 些 情况 的 不 同 之 处 在 于 , 从 三 维 纹理 中 选择 显示 的 数据 平面 。 讨论 顶点 着 色 器 时 ， 


会 回 过 头 来 探讨 这 一 点 。 








接 下 来 ， 利 用 SliceRender 演 染 二 维 切片 : 


def draw(self): 





每 个 二 维 切片 都 是 一 个 正方 


# clear buffers 
glClear(GL COLOR BUFFER BIT | GL DEPTH BUFFER BIT) 
# build projection matrix 

pMatrix = glutils.ortho(-0.6, 0.6, 
# modelview matrix 
mvMatrix = numpy.array([ 





-0.6, 0.6, 0.1, 100.0) 


.0], numpy.float32) 
# use shader 
glUseProgram(self.program) 


# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL FALSE, pMatrix) 


# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL FALSE, mvMatrix) 


# set current slice fraction 

glUniformif(glGetUniformLocation(self.program, b"uSliceFrac"), 
float(self.currSliceIndex)/float(self.currSliceMax)) 

# set current slice mode 

glUniform1i(glGetUniformLocation(self.program, 
self .mode) 


b"uSliceMode"), 


# enable texture 

glActiveTexture(GL_TEXTUREO) 

giBindTexture(GL TEXTURE 3D, self.texture) 
glUniform1i(glGetUniformLocation(self.program, b"tex"), 0) 


# bind VAO 

gliBindVertexArray (self.vao) 

# draw 

giDrawArrays(GL TRIANGLE STRIP, 0, 4) 
# unbind VAO 

glBindVertexArray (0) 























区， 是 用 OpenGL 的 三 角形 带 图 元 建立 的 。 这 段 代 











码 完 成 了 三 角形 带 
EO, EI 
OpenGL 绘制 























MARRE. WEA, 
个 投影 


影 ， 在 表示 切片 的 单位 正方 形 边 上 增加 0.1 的 缓冲 区 。 用 
图 (不 应 用 任何 转换 ) 将 眼睛 放 在 O, 0, 0,18 Fz $ 





请 注意 ， 我 们 用 glutils.ortho() 方 法 实现 了 正 投影 。 
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下 看 而 y 轴 朝 上 。 在 @ 行 ， 对 几何 形状 应 用 转换 (-0.5，-0.5，-1.0)， 让 它 围绕 z 
居中 。 在 @ 行 设置 当前 切片 的 分 数 ( 例 如 ，100 个 切片 中 的 第 10 个 将 是 0.1), 在 
@ 行 设置 切片 模式 (在 x, y 或 z 方 向 上 观看 切片 ， 分别 由 整数 0、1 和 2 表示 ， 并 
将 这 两 个 值 设置 给 着 色 器 。 





tom 





















































11.401 顶点 着 色 器 
现在 来 看 看 SliceRender 的 顶点 着 色 器 : 


# version 330 core 



































in vec3 aVert; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 


uniform float uSliceFrac; 
uniform int uSliceMode; 


out vec3 texcoord; 


void main() { 


// x slice 
if (uSliceMode == 0) { 

o texcoord = vec3(uSliceFrac, aVert.x, 1.0-aVert.y); 
} 
// y slice 
else if (uSliceMode == 1) { 

e texcoord = vec3(aVert.x, uSliceFrac, 1.0-aVert.y); 
j 
// z slice 
else { 

e texcoord = vec3(aVert.x, 1.0-aVert.y, uSliceFrac); 
} 


// calculate transformed vertex 
gl_Position = uPMatrix * uMVMatrix * vec4(aVert, 1.0); 

















} 
顶点 着 色 器 用 三 角形 带 顶 点 数组 作为 输入 ， 并 设置 一 个 纹理 坐标 作为 输出 。 当 









































前 切片 分 数 和 切片 模式 作为 uniform 变量 传 入 。 
在 @ 行 ， 计 算 x 切片 的 纹理 坐标 。 因 为 要 垂直 于 x 方向 切片 ， 所 以 希望 切片 平 
行 于 yz 平面 。 传 入 顶点 着 色 器 的 三 维 顶点 也 兼作 三 维 纹理 坐标 ， 因 为 它们 在 [0，1] 
的 范围 内 ， 所 以 纹理 坐标 由 Cf, Vx, Vy) 给 出 ， 其 中 f 是 x 轴 方 向 上 切片 编号 的 分 
数 ，Vx 和 Vy 是 顶点 坐标 。 遗 憾 的 是 ， 由 此 产生 的 图 像 是 倒 的 ， 因 为 OpenGL 坐标 
系统 的 原点 在 左下 角 ，y 方向 朝 上 。 这 和 我 们 希望 的 相反 。 为 了 解决 这 个 问题 ， 将 
纹理 坐标 t 改 为 (1 -t)， 采 用 Cf, Vx, 1 -Vy)， 如 O@ 行 所 示 。 在 @ 行 和 @ 行 ， 利 用 类 
似 的 逻辑 来 计算 y 和 z 方 向 上 切片 的 纹理 坐标 。 
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11.10.22 片段 着 色 器 
下 面 是 片段 着 色 器 : 


# version 330 core 
































© in vec3 texcoord; 


@ uniform sampler3D texture; 


out vec4 fragColor; 


void main() { 
// look up color in texture 


fragColor = col.rrra; 





在 @ 行 ， 片 段 着 色 器 声明 texcoord 作为 输入 ， 它 在 顶点 着 色 器 : 


























vec4 col = texture(tex, texcoord) ; 














设 为 输出 。 在 


























@ 行 ,该 纹理 采样 器 声明 为 uniform。 在 目 行 , 用 texcoord 查找 纹理 的 颜色 , 在 @ 行 ， 









































设置 fragColor 作为 输出 (因为 读 入 纹理 时 只 作为 红色 通道 ， 所 以 使 用 colrrra )。 


11.10.3 ”针对 二 维 切 片 的 用 户 界面 




















现在 需要 为 用 户 提供 一 种 方法 , 让 切片 经 过 这 些 数据 。 月 








理 程序 来 实现 。 


def keyPressed(self, key): 
"""keypress handler""" 
if key == 'x': 
self.mode = 
# reset slice index 
self .currSliceIndex 
self.currSliceMax = 
elif key 'y't 
self.mode 
# reset slice index 
self.currSliceIndex 
self.currSliceMax - 
elif key "Evi 
self.mode - 
# reset slice index 
self.currSliceIndex 
self.currSliceMax - 
elif key "Li 
self.currSliceIndex 
elif key us 
self.currSliceIndex 
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H SliceRender 的 键盘 处 


SliceRender.XSLICE 


- int(self.Nx/2) 
self .Nx 


= SliceRender.YSLICE 


= int(self.Ny/2) 
self .Ny 


SliceRender .ZSLICE 


= int(self.Nz/2) 
self .Nz 


= (self.currSliceIndex + 1) % self.currSliceMax 


self .currSliceMax 


= (self.currSliceIndex - 1) % 


11.11 





在 键盘 上 按 下 X. Y EK Z SI, SliceRender 切换 到 的 x、y 或 z 切片 模式 。 在 





@ 行 ， 可 以 看 到 x 切片 的 效果 ， 随 后 将 当前 切片 索引 设置 为 数据 的 : 
新 最 大 切片 数 。 按 下 键盘 上 的 左 、 右 箭头 键 ， 就 实现 了 切片 翻 页 。 在 @@ 行 ， 按 下 碳 
(96) 确保 在 超过 























箭头 时 切片 索引 递增 。 取 模 运算 符 


完整 的 二 维 切片 代码 























a 











间 位 置 ， 并 更 














最 大 值 时 索引 “翻转 ”为 0。 








以 下 是 完整 的 代码 清单 。 也 可 以 在 https://github.com/electronut/pp/tree/master/ 


volrender/ 找 到 slicerender.py 文件 。 
import OpenGL 

from OpenGL.GL import * 

from OpenGL.GL.shaders import * 
import numpy, math, sys 

import volreader, glutils 


strvS = """ 
# version 330 core 


in vec3 aVert; 


uniform mat4 uMVMatrix; 
uniform mat4 uPMatrix; 


uniform float uSliceFrac; 
uniform int uSliceMode; 


out vec3 texcoord; 
void main() { 


// x slice 
if (uSliceMode == 0) { 


texcoord = vec3(uSliceFrac, aVert.x, 
J 
|| y slice 
else if (uSliceMode -- 1) ( 
texcoord = vec3(aVert.x, uSliceFrac, 
j 
// z slice 
else { 
texcoord = vec3(aVert.x, 
} 


// calculate transformed vertex 


gl Position = uPMatrix * uMVMatrix * vec4(aVert, 


StrFS = """ 
# version 330 core 


in vec3 texcoord; 


1.0-aVert.y) ; 


1.0-aVert.y); 


1.0-aVert.y, uSliceFrac); 


1.0); 
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uniform sampler3D tex; 
out vec4 fragColor; 


void main() { 
// look up color in texture 
vec4 col = texture(tex, texcoord) ; 
fragColor = col.rrra; 


} 


class SliceRender: 
# slice modes 
XSLICE, YSLICE, ZSLICE = 0, 1, 2 


def | init (self, width, height, volume): 
"""SliceRender constructor""" 
self.width - width 
self.height - height 
self.aspect = width/float(height) 


# slice mode 
self.mode = SliceRender.ZSLICE 


# create shader 
self.program = glutils.loadShaders(strVS, strFS) 


glUseProgram(self.program) 


self.pMatrixUniform = glGetUniformLocation(self.program, b'uPMatrix') 

self.mvMatrixUniform = glGetUniformLocation(self.program, 
b"uMVMatrix") 

# attributes 

self.vertIndex = glGetAttribLocation(self.program, b"aVert") 


# set up vertex array object (VAO) 
self.vao = glGenVertexArrays(1) 
giBindVertexArray (self.vao) 


# define quad vertices 
vertexData - numpy.array([ 


J 

], numpy.float32) 

# vertex buffer 

self.vertexBuffer = glGenBuffers(1) 

giBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 

glBufferData(GL ARRAY BUFFER, 4*len(vertexData), vertexData, 
GL_STATIC_DRAW) 

# enable arrays 

glEnableVertexAttribArray(self.vertIndex) 

# set buffers 

glBindBuffer(GL ARRAY BUFFER, self.vertexBuffer) 

glVertexAttribPointer(self.vertIndex, 3, GL FLOAT, GL FALSE, O, None) 


# unbind VAO 
glBindVertexArray (0) 
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def 


def 


def 


# load texture 
self.texture, self.Nx, self.Ny, self.Nz = volume 


# current slice index 
self.currSliceIndex = int(self.Nz/2); 
self.currSliceMax = self.Nz; 


reshape(self, width, height): 
self.width - width 

self.height - height 

self.aspect = width/float(height) 


draw(self): 

# clear buffers 
glClear(GL_COLOR_BUFFER_BIT | GL DEPTH BUFFER BIT) 

# build projection matrix 

pMatrix = glutils.ortho(-0.6, 0.6, -0.6, 0.6, 0.1, 100.0) 
# modelview matrix 
mvMatrix = numpy.array([ 





.0, 
.0, 
.0， 
, 1.0], numpy.float32) 


# use shader 
glUseProgram(self.program) 


# set projection matrix 
glUniformMatrix4fv(self.pMatrixUniform, 1, GL FALSE, pMatrix) 


# set modelview matrix 
glUniformMatrix4fv(self.mvMatrixUniform, 1, GL FALSE, mvMatrix) 


# set current slice fraction 

glUniformif(glGetUniformLocation(self.program, b"uSliceFrac"), 
float(self.currSliceIndex)/float(self.currSliceMax)) 

# set current slice mode 

glUniform1i(glGetUniformLocation(self.program, b"uSliceMode") , 
self .mode) 


# enable texture 

glActiveTexture(GL_TEXTUREO) 

giBindTexture(GL TEXTURE 3D, self.texture) 
glUniform1i(glGetUniformLocation(self.program, b"tex"), 0) 


# bind VAO 
gliBindVertexArray (self .vao) 

# draw 
glDrawArrays(GL_TRIANGLE_STRIP, 0, 4) 
# unbind VAO 

giBindVertexArray (0) 


keyPressed(self, key): 

"""keypress handler""" 

if key == 'x': 
self.mode = SliceRender.XSLICE 
# reset slice index 
self.currSliceIndex = int(self.Nx/2) 
self.currSliceMax = self .Nx 

elif key == 'y': 
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self.mode = SliceRender.YSLICE 
# reset slice index 
self.currSliceIndex = int(self.Ny/2) 
self.currSliceMax = self.Ny 

elif key == 'z': 
self.mode = SliceRender.ZSLICE 
# reset slice index 
self.currSliceIndex = int(self.Nz/2) 
self.currSliceMax = self .Nz 


elif key == '1l': 
self.currSliceIndex = (self.currSliceIndex + 1) % self.currSliceMax 
elif key == 'r': 


self.currSliceIndex = (self.currSliceIndex - 1) % self.currSliceMax 


def close(self): 
pass 


11.12 代码 整合 




















se 
































上 我 们 快速 看 看 项 目的 主 文件 volrenderpy。 该 文件 用 到 RenderWin 类 , 它 创 建 














并 管理 GLFW 的 OpenGL 窗口 《这 里 不 会 详细 介绍 该 类 , 因为 它 类 似 于 第 









































9 章 和 第 


10 章 中 使 用 的 类 )。 要 查看 volrenderpy 的 完整 代码 ， 请 直接 跳 到 11.13 5. 



























































在 这 个 类 的 初始 化 代码 中 ， 创 建 了 演 染 器 ， 如 下 所 示 : 


# load volume data 
























































o self.volume - volreader.loadVolume(imageDir) 
# create renderer 
e self.renderer - RayCastRender(self.width, self.height, self.volume) 
在 @ 行 ， 读 入 三 维 数据 作 为 OpenGL 纹理 。 在 @ 行 ， 创 建 RayCastRender 类 型 
的 对 象 来 显示 数据 。 
键盘 上 按 下 V 键 ， 在 体 演 染 和 切片 演 染 之 间 切 换 。 下 面 是 RenderWindow 的 键 
盘 处 理 程序 : 
def onKeyboard(self, win, key, scancode, action, mods): 
# print 'keyboard: ', win, key, scancode, action, mods 


# ESC to quit 
if key is glfw.GLFW_KEY_ESCAPE: 
self .renderer.close() 
self.exitNow = True 
else: 
o if action is glfw.GLFW PRESS or action is glfw.GLFW REPEAT: 
if key -- glfw.GLFW KEY V: 
# toggle render mode 
e if isinstance(self.renderer, RayCastRender) 
self.renderer - SliceRender(self.width, self.height, 
self.volume) 
else: 
self.renderer - RayCastRender(self.width, self.height, 
self.volume) 
# call reshape on renderer 
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self.renderer.reshape(self.width, self.height) 


else: 
# send keypress to renderer 
e keyDict = ([glfw.GLFW KEY X: 'x', glfw.GLFW KEY Y: 'y', 
glfw.GLFW KEY Z: 'z', glfw.GLFW KEY LEFT: 'l', 
glfw.GLFW KEY RIGHT: 'r') 
try: 
self.renderer.keyPressed(keyDict[key]) 
except: 
pass 









































按 ESC 键 退出 程序 。 其 他 按键 CV. X. Y. Z 等 ) 在 @ 行 处 理 〈 无 论 刚 刚 按 下 
该 键 ， 或 者 保持 按 下 状态 ， 代 码 都 有 效 )。 在 @ 行 ， 如 果 按 下 V 键 ， 在 体 演 染 和 切 
片 泻 染 之 间 切 换 ， 利 用 Python 的 isinstance0 方 法 来 确定 当前 类 的 类 型 。 

要 处 理 除 ESC 之 外 的 按键 事件 , 我 们 使 用 一 个 字典 @， 将 按 下 的 键 传 入 泻 染 器 
的 keyPressed() 处 理 程序 。 
















































































注意 我 没有 直接 传 入 glfw.KEY 值 ， 而 是 利用 字典 将 它们 转换 为 字符 值 ， 因 为 
这 是 很 好 的 做 法 ， 目 的 是 减少 源 文件 中 的 依赖 关系 。 目 前 ， 项 目 中 依赖 GLFW 
的 唯一 文件 是 volrenderpy。 如 果 将 GLFW 相关 的 类 型 传 入 其 他 代码 ， 它 们 就 
需要 导入 并 依赖 GLEW 库 ， 但 如 果 切 换 到 另 一 个 OpenGL 窗口 工具 包 ， 代 码 
就 乱 了 。 





11.13 ”完整 的 主 文件 代码 


以 下 是 完整 的 代码 清单 。 也 可 以 在 https://github.com/electronut/pp/tree/master/ 
volrender/ 找 到 volrender.py 文件 。 





import sys, argparse, os 
from slicerender import * 
from raycast import * 
import glfw 


class RenderWin: 
"""GLFW Rendering window class""" 


def | init (self, imageDir): 


# save current working directory 
cwd = os.getcwd() 


# initialize glfw; this changes cwd 
glfw.glfwInit() 


# restore cwd 
os.chdir(cwd) 


# version hints 


951139: 体 泻 染 207 


glfw.glfwWindowHint(glfw.GLFW CONTEXT VERSION MAJOR, 3) 
glfw.glfwWindowHint(glfw.GLFW CONTEXT VERSION MINOR, 3) 
glfw.glfwWindowHint(glfw.GLFW OPENGL FORWARD COMPAT, GL TRUE) 
glfw.glfwWindowHint(glfw.GLFW OPENGL PROFILE, 
glfw.GLFW OPENGL CORE PROFILE) 


# make a window 

self.width, self.height - 512, 512 

self.aspect = self.width/float(self.height) 

self.win = glfw.glfwCreateWindow(self.width, self.height, b"volrender") 
# make context current 

glfw.glfwMakeContextCurrent(self.win) 


# initialize GL 

glViewport(0, 0, self.width, self.height) 
glEnable(GL_DEPTH_TEST) 

glClearColor(0.0, 0.0, 0.0, 0.0) 


# set window callbacks 
glfw.glfwSetMouseButtonCallback(self.win, self .onMouseButton) 
glfw.glfwSetKeyCallback(self.win, self.onKeyboard) 
glfw.glfwSetWindowSizeCallback(self.win, self.onSize) 


# load volume data 

self.volume = volreader.loadVolume(imageDir) 

# create renderer 

self.renderer = RayCastRender(self.width, self.height, self.volume) 


# exit flag 
self.exitNow = False 


def onMouseButton(self, win, button, action, mods): 
# print ‘mouse button: ', win, button, action, mods 
pass 


def onKeyboard(self, win, key, scancode, action, mods): 
# print ‘keyboard: ', win, key, scancode, action, mods 
# ESC to quit 
if key is glfw.GLFW_KEY_ESCAPE: 
self.renderer.close() 
self.exitNow = True 
else: 
if action is glfw.GLFW_PRESS or action is glfw.GLFW_REPEAT: 
if key == glfw.GLFW_KEY_V: 
# toggle render mode 
if isinstance(self.renderer, RayCastRender): 
self.renderer = SliceRender(self.width, self.height, 
self .volume) 
else: 
self.renderer - RayCastRender(self.width, self.height, 
self.volume) 
# call reshape on renderer 
self.renderer.reshape(self.width, self .height) 
else: 
# send keypress to renderer 
keyDict = {glfw.GLFW_KEY_X: 'x', glfw.GLFW_KEY_Y: 'y', 
glfw.GLFW KEY Z: 'z', glfw.GLFW KEY LEFT: '‘1', 
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glfw.GLFW KEY RIGHT: 'r') 
try: 
self.renderer.keyPressed(keyDict[key]) 
except: 
pass 


def onSize(self, win, width, height): 
#print 'onsize: ', win, width, height 
self.width - width 
self.height - height 
self.aspect = width/float(height) 
glViewport(0, 0, self.width, self.height) 
self.renderer.reshape(width, height) 


def run(self): 

# start loop 

while not glfw.glfwWindowShouldClose(self.win) and not self.exitNow: 
# render 
self.renderer.draw() 
# swap buffers 
glfw.glfwSwapBuffers(self.win) 
# wait for events 
gifw.glfwWaitEvents() 

# end 

glfw.glfwTerminate() 


4 main() function 
def main(): 
print('starting volrender...') 
# create parser 
parser = argparse.ArgumentParser(description-"Volume Rendering...") 
# add expected arguments 
parser.add argument('--dir', dest-'imageDir', required-True) 
# parse args 
args = parser.parse_args() 


# create render window 
rwin = RenderWin(args.imageDir) 
rwin.run() 


# call main 
if name == ' main 
main() 





11.14 ”运行 程序 


下 面 是 用 斯 坦 福 体 数 据 档案 (Stanford Volume Data Archive) “的 数据 来 运行 应 
用 程序 的 示例 


$ python volrender.py --dir mrbrain-8bit/ 


应 该 看 到 如 图 11-6 所 示 的 画面 。 
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(D http://graphics.stanford.edu/data/voldata/ 
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11-6 virenderby 运行 示例 。 左 侧 的 图 像 是 体 泻 染 ， 右 侧 的 图 像 是 二 维 切片 


11.15. 小结 


本 章 用 Python 和 OpenGL 实现 了 体 光 线 投射 算法 ,我 们 学 习 了 如 何 用 GLSL 着 
色 器 有 效 地 实现 这 个 算法 ， 以 及 如 何 从 体 数据 创建 二 维 切 片 。 









































11.16 实验 


这 里 有 一 些 方法 ， 让 你 继续 完善 体 光线 投射 程序 。 
1. 目前 ， 在 光线 投射 模式 下 ， 很 难看 到 的 体 数据 “立方 体 ” 的 边界 。 请 实现 
一 个 WireFrame 类 ， 围 绕 该 立方 体 绘制 一 个 盒子 。 分 别 用 红 、 绿 、 蓝 色 绘 制 x、y 
Al z 轴 ， 让 它们 每 个 都 有 自己 的 着 色 器 。 在 RayCastRender 类 中 使 用 WireFrame。 
2. 实现 数据 刻度 。 在 当前 的 实现 中 ， 针 对 物体 绘制 了 一 个 正方 体 ， 针 对 二 维 
切片 了 一 个 正方 形 ， 这 假定 数据 集 是 对 称 〈 即 切片 的 数目 在 每 个 方向 上 相同 )， 但 
大 多 数 实际 数据 具有 不 同 数目 的 切片 。 特 别 是 医疗 数据 , 常常 在 z 方 向 的 切片 较 少 ， 
例如 ， 维 度 是 256X256X99。 要 正确 显示 这 些 数 据 ， 必 须 在 计算 中 引入 刻度 。 一 种 
做 法 是 将 刻度 应 用 于 立方 体 的 顶点 (三 维 物 体 )， 和 正方 形 的 顶点 (二 维 切 片 )。 然 
后 用 户 可 以 输入 刻度 参数 作为 命令 行 参数 。 
3. 我 们 的 体 光 线 投射 实现 使 用 了 x 射线 投射 来 计算 像素 的 最 终 颜 色 或 强度 。 另 
一 种 流行 的 实现 方式 是 用 最 大 强度 投影 (maximum intensity projection，MIP)， 在 每 
个 像素 上 设置 最 大 强度 。 在 代码 中 实现 这 一 点 (提示 : 在 RayCastRender 的 片段 着 色 
器 中 ， 修 改 逐 步 穿 透 光 线 的 代码 ， 沿 着 光线 检查 并 设置 最 大 值 ， 代 蔡 混合 值 )。 
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4. 目前 , 唯一 实现 的 用 户 界面 是 围绕 x 轴 、y IURI z 轴 旋 转 。 请 实现 缩放 功能 ， 
按 工 键 或 O 键 来 放大 或 缩小 体 泻 染 图 像 。 可 以 在 glutils.lookAtO 方 法 中 设置 适当 的 
相机 参数 来 实现 ， 有 一 点 需要 注意 : 如 果 将 观察 位 置 移动 到 立方 体内 部 ， 光 线 投射 
将 失败 ， 因 为 OpenGL 会 裁剪 立方 体 的 正面 。 光 线 投射 所 需 的 光线 计算 ， 同 时 需要 
彩色 立方 体 的 正面 和 背面 才能 正确 泻 染 。 作 为 蔡 代 方案 ， 通 过 在 glutils.projecton() 
方法 中 调节 视 场 来 实现 缩放 。 
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第 五 部 分 


玩 转 硬件 


“系统 中 的 那些 可 以 用 锤子 击 打 不 建议 这 么 做 ) 的 部 分 称 为 硬件 


























那些 只 能 贺 骂 的 程序 指令 称 为 软件 。” 
一 佚名 
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Arduino 简介 





























Arduino 是 一 个 简单 的 微 控 制 器 板 卡 ， 是 基于 可 编程 芯片 的 开源 
开发 环境 。 所 有 版 本 的 Arduino 都 包含 计算 机 的 标准 组 件 ， 如 内 
存 、 处 理 器 和 输入 /输出 系统 。 

在 本 章 中 , 我 们 将 在 Arduino 的 帮助 下 开始 进入 微 控制 器 的 
世界 。 我 们 将 学 习 Arduino 平台 的 基础 知识 , 以 及 如 何 用 Arduino 
编程 语言 (C++ 的 一 个 版 本 ) 构建 Arduino 程序 。 我 们 将 学 习 如 
何 对 Arduino 进行 编程 ， 从 一 个 简单 的 光 传感器 电路 收集 数据 ， 然 后 通过 串 行 端口 
将 数据 发 送 给 计算 机 。 接 下 来 ， 我 们 将 用 pySerial 通过 串口 与 Arduino 交互 ， 收 集 
数据 ， 并 用 matplotlib 实时 绘制 图 形 。 新 值 输 入 时 ， 图 形 将 向 右 深 动 ， 就 像 EKG H 
视 嚣 一样。 其 电路 设置 如 图 12-1 所 示 。 
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图 12-1 简单 的 光敏 电阻 (LDR) 电路 ， 在 面包 板 上 搭建 ， 并 连接 到 Arduino Uno 


12.1 Arduino 


Arduino 是 围绕 一 类 名 为 Atmel AVR 的 微 控 制 器 芯片 构建 的 平台 。 市 场 上 有 许 
多 不 同 尺 寸 和 功能 的 Arduino W. B| 12-2 突出 了 Arduino Uno 板 卡 的 一 些 主要 组 件 ， 
这 是 比较 常见 的 、 可 以 获得 的 板 卡 。Arduino 板 上 的 接头 (如 图 12-2 所 示 ) 允许 你 
访问 微 控 制 器 的 模拟 和 数字 引 脚 ,以 便 通 过 发 送 和 接收 数据 , 与 其 他 电子 设备 通信 。 
(我 推荐 阅读 John Boxall 的 《Arduino Workshop》 一 书 [No Starch Press，2013]， 以 
便 更 好 地 理解 Arduino 的 电子 和 编程 知识 。) 
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USB 连 接 器 数字 输入 /输出 引 脚 
H 


外 部 编程 


微 控制 器 


外 A 电源 供 应 


12-2 Arduino Uno 板 卡 的 组 件 





注意 虽然 本 书 的 项 目 中 使 用 Arduino Uno 板 ， 但 你 应 该 能 够 使 用 非 官方 的 板 卡 。 
如 果 打 算 这 样 做 ， 请 参阅 Arduino 网 站 (http:Warduino.cc/ )， 了 解 板 卡 之 间 的 区 
别 。 例 如 ， 一 些 板 卡 的 引 脚 编 号 惯例 与 Uno 不 同 。 





Arduino Uno 有 一 个 微 控 制 器 芯片 ， 一 个 通用 串 行 总 线 CUSBO 连接 ， 一 个 用 
于 外 部 电源 的 插 孔 ， 一 些 数字 输入 /输出 引 脚 ， 一 些 模拟 引 脚 ， 可 供 外 部 电路 使 用 的 
电源 输出 ， 甚 至 有 直接 对 芯片 编程 的 引 脚 。 

Arduino 板 卡 包 括 一 个 “引导 加 载 程序 (bootloader)”， 它 是 一 个 程序 ， 让 你 上 
传代 码 并 在 微 控 制 器 上 运行 。 如 果 没 有 引导 加 载 程序 ， 则 要 用 “在 线 串 行 编程 技术 
(ICSP)” 与 微 控 制 器 进行 交互 (通过 名 为 ICSP 头 的 外 部 编程 引 脚 ，Arduino 支持 
了 ICSP)。Arduino 易于 编程 ， 因 为 可 以 通过 USB 端口 将 它 连 接 到 计算 机 ， 并 用 
Arduino 软件 将 代码 上 传 到 电路 板 。 

Arduino 板 卡 最 重要 的 组 件 是 AVR 微 控制 器 ， 它 是 一 个 单 片 计算 机 。Arduino 
Uno 上 的 AVR 微 控 制 器 是 一 个 ATmega328 芯片 。 它 有 中 央 处 理 单元 (CPU)、 定 时 
上 器/ 计数器、 模拟 和 数字 引 脚 、 存 储 器 模块 和 时 钟 模块 等 。 蕊 片 的 CPU 执行 上 传 的 
程序 。 定 时 器 /计数 器 模块 可 用 于 在 程序 内 创建 周期 性 事件 (例如 每 秒 检查 某 个 数字 
引 脚 的 值 )。 模 拟 引 脚 使 用 模 数 转换 器 (ADC) 模块 将 输入 的 模拟 信号 转换 为 数字 
值 ， 数 字 引 脚 可 以 作为 输入 或 输出 ， 具 体 取决 于 如 何 设置 。 
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12.2 Arduino 生态 系统 


Arduino 处 在 一 个 生态 系统 的 中 心 ， 这 个 生态 系统 将 编程 语言 与 集成 开发 环境 
GDE)、 支 持 性 和 创造 性 的 社区 以 及 大 量 外 设 结合 起 来 。 
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Wiring〉 原 型 语言 。 它 的 设计 目的 是 让 不 熟悉 编程 的 人 容易 使 月 


的 程序 称 为 “草图 (sketches )”( 有 关 Arduino 编程 语言 的 更 多 信息 ， 请 访问 














http://arduino.cc/). 


12.2.2 IDE 


Arduino 包括 一 个 简 








Arduino 编程 语言 是 C++ 的 简化 版 本 ， 起 源 于 处 理 和 布线 〈Processing and 


月 。 为 Arduino 编写 





的 IDE， 可 以 在 其 中 创建 草图 并 上 传 到 Arduino C LA 
12-3). IDE 还 包括 一 个 “ 串 行 监视 器 (serial monitor)”, 可 以 通过 让 Arduino 44 


ao 

















口 向 计算 机 发 送信 息 ， 来 调试 应 用 程序 。 此 外 ，IDE 还 包括 几 个 示例 程序 ， 以 及 一 
系列 标准 库 ， 用 于 执行 常见 任务 ， 并 与 外 部 的 外 设 板 卡 接口 。 


12.2.3 社区 








Arduino 有 一 个 庞大 的 月 
区 寻求 帮助 。Arduino 社区 已 经 开发 了 许多 ] 








eoo ardu_alert | Arduino 1.0.5 


EIE 


ardu alert.ino 
^ read serial port and turn leds on/off 
Mahesh Venkitachalam 
electronut.in 
#include "Arduino.h" 
/ LED pin number digital) 
int pinRed = 4; 
int pinGreen = 2; 


void setup() 
1 
initialize serial comms 
Serial .begin(9608); 


et pins 
pinMode(pinRed, OUTPUT); 
pinMode(pinGreen, OUTPUT); 


void loop() 
1 


A 
M 


12-3 Arduino IDE 中 的 示例 程序 





























日 户 群 ， 如 果 对 一 个 项 目 有 疑问 ， 你 可 以 向 Arduino 社 
于 源 库 ， 可 以 在 你 的 项 目 中 使 用 ， 如 果 











用 Arduino 连接 一 些 传感器 模块 时 遇 到 困难 ， 很 可 能 有 人 已 经 解决 了 这 个 问题 ， 并 
提供 了 一 个 库 ， 使 你 的 生活 更 轻松 。 
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12.2.4 5Ni& 


与 所 有 流行 的 平台 一 样 ， 围 绕 Arduino 平台 建立 了 一 个 产业 。 大 量 的 功能 扩展 
板 〈 可 以 方便 地 安装 在 Arduino 上 ， 以 便 访问 传感器 和 其 他 电子 元 件 的 板 卡 )、 分 线 
板 《〈 可 以 方便 地 连接 难以 焊接 的 元 件 / 电 路 ) 和 其 他 外 设 ， 都 可 用 于 Arduino， 其 中 
许多 可 以 让 你 的 项 目 更 简单 。SparkFun Electronics Chttps://www.sparkfun.com/) 和 
Adafruit Industries Chttp://www.adafruit.com/) 是 两 家 公司 ， 它 们 分 别提 供 了 许多 可 
与 Arduino 一 起 使 用 的 产品 。 




















































































































12.3 ”所 需 模块 





既然 已 经 知道 了 Arduino 的 一 些 基 础 知识 ， 就 让 我 们 看 看 如 何 对 板 卡 编程 ， 从 
光 感 测 电路 读 取 数 据 。 除 了 Arduino， 我 们 还 需要 两 个 电阻 和 两 个 “光敏 电阻 
CLDR)”。 电 阻 用 于 减少 通过 电路 的 电流 并 降低 电压 。 我 们 将 使 用 光敏 电阻 〈 也 称 
为 photoresistor)， 其 电阻 随 着 光照 强度 的 增加 而 减 小 。 我 们 还 需要 一 个 面包 板 和 一 
些 电 线 来 搭 电 路 ， 并 用 万 用 表 来 检查 连接 。 


















































































































































12.4 搭建 感光 电路 


12.4.1 


首先 ， 我 们 将 搭建 感光 电路 ， 它 由 两 个 常规 电阻 和 两 个 LDR 组 成 。 图 12-4 展 
示 了 感光 电路 的 电路 图 (附录 B 包含 如 何 开始 搭建 电子 电路 的 一 些 基 本 信息 )。 

在 图 12-4 F, VCC 表示 连接 到 Arduino 的 5V 输出 ， 它 为 电路 供电 。 标 记 为 
LDRI 和 LDR2 的 元 件 是 两 个 光敏 电阻 , AO 和 Al 是 Arduino 的 模拟 引 脚 0 和 1 (这 
些 模拟 引 脚 允许 微 控 制 器 从 外 部 电路 读 取 电 压 电 平 )。 你 还 可 以 看 到 电阻 R1 和 R2, 
以 及 接地 (GND) 连接 , 它 可 以 是 Arduino 上 的 任何 GND 引 脚 。 可 以 在 面包 板 ( 带 
弹簧 夹 的 塑料 板 , 用 于 在 不 焊接 的 情况 下 组 装 电路 ) 上 搭建 电路 , 用 少量 电线 连接 ， 
如 图 12-1 所 示 。 












































































































































电路 工作 原理 
在 该 电路 中 ， 每 个 LDR 和 它 下 面 的 电阻 ， 构 成 了 “电阻 分 压 器 ”， 这 是 一 个 

































































简单 电路 ， 用 两 个 电阻 将 输入 电压 分 为 两 部 分 。 该 设置 意味 着 AO 处 的 电压 计算 
如 下 : 
"EEN. I 
R p +R 


LDR 1 


RI 是 电阻 的 阻 值 ，Ripr 是 LDR 的 阻 值 。V EHR HA, Vo FE RI 两 端的 电压 。 
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随 着 照 在 LDR 上 的 光 强 度 改变 , 它 的 电阻 也 改变 ， 因 此 它 两 端的 电压 也 相应 地 改 

















变 。 电 压 (0 至 5 伏特 之 间 ) 在 AO 处 读 取 ， 并 作为 10 位 值 发 送 给 程序 ， 范 














[0,1023]。 即 电压 范围 映射 为 [0,1023] 的 整数 。 


在 电路 中 使 用 的 R 和 Rs 电阻 的 值 取决 于 选择 的 LDR。 如 果 ) 
阻 会 降低 ， 因 此 Riper 减 小 , 这 意味 着 Vo 增加 ， Arduino 








































































































围 为 


光照 LDR， 其 电 


从 连接 到 该 LDR 的 模拟 引 



























































































































































脚 处 读 入 较 高 的 值 。 要 确定 Ri 和 Rs 所 需 的 电阻 值 ， 请 在 不 同 光线 条 件 下 用 万 用 表 














测量 LDR 的 电阻 , 并 将 该 值 代入 电压 公式 。 你 希望 在 使 用 LDR 的 光照 变化 场景 下 
电压 有 良好 的 变化 《从 OV 到 5V). 

我 最 后 用 了 4.7k 欧姆 电阻 作为 Ri 和 Ro, 因为 我 的 LDR 的 电阻 从 大 约 10k 欧姆 
(在 黑 上 暗中) 变化 到 Uk 欧姆 (在 明亮 的 光线 中 )。 将 这 些 值 代入 上 一 个 公式 中 ,会 
人 输入 需要 Lev 至 4V 的 电压 范围 。 构 建 电 路 时 ， 可 以 从 4.7k 欧姆 电阻 开 

台 ， 并 根据 需要 更 改 它们 。 
VCC 


12.4.2 Arduino 程序 
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现在 来 编写 Arduino 程序 。 下 面 是 运行 在 Arduino 


信号 ， 并 通过 串 





LDR1 


R1 





— GND 


12-4 简单 感光 电路 的 示意 图 

















口 将 它们 发 送 给 计算 机 : 


#include "Arduino.h" 


void setup() 

{ 
// initializ 
Serial.begin 


} 
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e Serial communications 
(9600) ; 





上 的 代码 ， 让 它 从 电路 读 取 


void loop() 


{ 
// read AO 
e int vali = analogRead(0); 
// read A1 
e int val2 - analogRead(1); 


// print to serial 

o Serial.print(val1); 
Serial.print(" "); 
Serial.print(val2) ; 
Serial.print("\n"); 
// wait 

e delay(50); 

} 











在 @ 行 , 在 setup0) 方 法 中 启用 串口 通信 。 因 为 setup0 仅 在 程序 启动 时 调用 















































a a E. 这 里 将 串口 通信 




















位 / 秒 为 单位 ) 初始 化 为 
足够 快 了 。 


主要 代码 位 于 loop0 方 法 中 。 在 @ 行 ， 从 模拟 引 脚 0〈 范 
10 位 整数 ) 读 取 当 前 信号 值 ， 

















9600， 这 是 大 多 数 设 备 的 默认 值 ， 









































的 波 特 率 《速度 ， 以 
对 你 的 任务 来 说 





{x 


围 在 [0,1023] 中 的 一 个 











在 @ 行 ， 从 引 脚 1 读 取 当 前 信号 值 。 在 @ 行 和 随后 几 








ÍT, 用 Serial.print0 将 值 发 送 给 计算 机 ,格式 化 为 两 个 整数 ， 以 空格 分 隔 ， 后跟 换行 
符 。 在 @ 行 ， 用 delay0 延 组 操作 指定 的 时 间 ， 在 这 里 是 50 毫秒 ， 然 后 循环 重复 。 





























这 里 采用 的 值 决 定 了 AVR 


























微 控制 器 执行 loop0 方 法 的 速度 。 





为 了 将 程序 上 传 到 Arduino, 将 Arduino 连接 到 计算 机 ， 启 动 其 IDE， 并 启动 一 

















个 新 项 目 。 然 后 在 程序 窗口 : 




















和 语法 相关 的 错误 与 警告 。 
果 在 这 个 阶段 没有 看 
应 该 看 到 类 似 这 样 的 结果 : 











b 























512 300 
513 280 
400 200 





I 任何 错误 ， 























如 果 一 切 正 常 ， 单 击 Upload 将 草 























输入 代码 ， 单 击 Verify 以 编译 代码 。IDE 将 显示 所 有 





图 发 送 给 Arduino。 如 


从 Arduino 软件 的 工具 菜单 中 调 出 串口 监视 器 ， 











这 些 是 从 模拟 引 脚 0 和 1 读 取 的 模拟 值 , 并 通过 Arduino 的 USB 口 串 行 发 送 给 


计算 机 。 


12.4.3 ”创建 实时 图 表 






































为 了 在 项 目 中 实现 滚动 的 实时 图 ， 需 要 使 用 一 个 deque， 









































如 第 4 章 所 述 。deque 


FAN 个 值 的 数组 构成 ,在 任 一 端 添 加 和 删除 值 都 能 很 快 完成 。 新 值 出 现时 ， 它 们 被 





添加 到 deque， 并 且 最 老 的 值 被 弹出 。 以 固定 间隔 绘制 这 些 值 ， 就 会 生成 实时 图 ， 




















其 中 最 新 的 数据 总 是 在 左 仙 











| 添加 。 
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12.5 Python 代码 





























该 类 的 构造 函数 : 


class AnalogPlot: 
# constructor 


def | init__(self, strPort, maxLen): 


# open serial port 


o self.ser = serial.Serial(strPort, 9600) 
e self.aO0Vals = deque([0.0]*maxLen) 

e self.aiVals = deque([0.0]*maxLen) 

(4) self.maxLen = maxLen 


72.047, AnalogPlot 


Cm 









































Aot m dod 
[t (ux Es à 
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现在 来 看 看 从 串口 读 取 数 据 的 Python 程序 (完整 的 项 目 代 码 , 请 跳 到 12.6 节 )。 
为 了 更 好 地 组 织 代码 ， 我 们 定义 一 个 类 AnalogPlot， 它 保存 要 绘制 的 数据 。 下 面 是 




















的 构造 函数 利用 pySerial 库 创 建 一 个 Serial 对 象 。 我 们 



































maxLen 保存 在 AnalogPlot 对 象 中 。 
， 我 们 用 deque 对 象 缓冲 最 近 的 值 ， 如 AnalogPlot 类 中 








为 了 实时 绘制 模拟 值 
所 示 。 


# add data 
def add(self, data): 




















assert(len(data) == 2) 
o self.addToDeq(self.aO0Vals, data[0]) 
e self.addToDeq(self.atiVals, data[1]) 


# add to deque; pop oldest value 


def addToDeq(self, buf, 
buf .pop() 
buf .appendleft (val) 


oo 


正如 你 前 面 看 到 的 ，Arduino 每 行 仅 发 送 两 




















val): 


























该 类 与 Arduino 的 串口 通信 。Serial 构造 函数 的 第 一 个 参数 是 端口 名 称 字符 

可 以 在 IDE 中 通过 选择 Tools? Serial Port 找 到 它 
类 似 于 COM3， 在 Linux 和 OS X 上 ， 类 似 于 /dev/tty.usbmodem411)。Serial 
函数 的 第 二 个 参数 是 波 特 率 , 我 们 设置 为 9600, 以 匹配 Arduino 程序 中 设置 


PS As 


(在 Windows 上 ， 该 字符 








在 四 行 和 和 目 行 ， 创 建 了 deque 对 象 来 保存 模拟 值 。 我 们 使 用 大 小 为 maxLen 的 
全 零 列 表 初 始 化 deque 对 象 ， 这 是 在 给 定时 间 绘 制 的 值 的 最 大 数量 。 在 @ 行 ， 这 个 





个 模拟 整数 值 。 在 add0 方 法 中 ， 在 





@ 行 和 @@ 行 ,每 个 模拟 引 脚 的 数据 值 都 用 addToDeq() 方 法 添加 到 两 个 deque 对 象 中 。 





在 自行 和 @ 行 ， 这 个 方法 用 pop0 方 法 从 deque 的 尾部 删除 最 老 的 值 ， 然 后 用 





appendleft(0 方 法 将 最 新 的 
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直 添 加 到 deque 的 头 部 。 在 绘 1 


新 的 值 始终 显示 在 图 形 的 左 侧 。 


BK A 1% deque 的 值 时 ， 最 


ooo 


00000 


























我 们 利用 matplotlib 的 animation 类 ， 以 设置 的 间隔 更 新 绘图 〈 你 可 能 还 记得 ， 
在 第 5 章 的 Boids 项 目 中 看 到 过 )。 下 面 是 AnalogPlot 中 的 update() 方 法 ， 它 将 在 绘 
制 动 画 的 每 一 步 中 调用 : 


# update plot 
def update(self, frameNum, aO, a1): 
try: 
line = self.ser.readline() 
data = [float(val) for val in line.split()] 
# print data 
if(len(data) == 2): 



















































































self .add(data) 

a0.set data(range(self.maxLen), self.a0Vals) 

a1.set_data(range(self.maxLen), self.aiVals) 
except: 

pass 


return a0, a1 


在 @ 行 ，update() 方 法 将 一 行 串口 数据 读 入 为 一 个 字符 串 ， 在 @ 行 ， 利用 Python 
的 列表 解析 ， 将 值 转换 为 浮 点 数 ， 并 保存 在 列表 中 。 我 们 用 split0 方 法 根据 空格 来 
分 割 字符 串 ， 以 便 将 串口 读 入 的 字符 串 512 600\n 转换 为 [512,600]。 

检查 数据 有 两 个 值 之 后 ,在 @ 行 用 AnalogPlot 的 add0 方 法 将 值 添加 到 deque。 在 
@ 行 和 @ 行 ， 利 用 matplotlib 的 set_data0) 方 法 ， 用 新 值 更 新 图 形 。 每 次 绘图 的 x 值 是 
一 系列 数字 [0，... maxLen]， 用 range0 方 法 设置 。y 值 用 更 新 的 deque 对 象 来 填充 。 
所 有 这 些 代码 都 包含 在 try 语句 块 中 ， 如 果 发 生 异 常 ， 代 码 跳 转 到 @ 行 的 pass， 
在 这 里 忽略 读 入 数据 (pass 不 做 任何 事情 )。 使 用 try 语句 块 是 因为 ， 串 口 数据 有 时 
可 能 因 电 路 中 接触 不 良 而 损坏 ， 而 我 们 不 希望 仅仅 因为 串口 发 送 了 一 些 坏 的 值 ， 程 
FF AYE o 

准备 退出 时 ， 关 闭 串口 以 释放 所 有 系统 资源 ， 如 下 所 示 ; 


# clean up 

def close(self): 
# close serial 
self.ser.flush() 
self.ser.close() 


在 main() 方 法 中 ， 需 要 设置 matplotlib 动画 : 
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# set up animation 

fig = plt.figure() 

ax = plt.axes(xlim-(0, maxLen), ylim-(0, 1023)) 

80, = ax.plot([], []) 

ai, = ax.plot([], []) 

anim - animation.FuncAnimation(fig, analogPlot.update, 
fargs-(a0, a1), interval-20) 


# show plot 
plt.show() 


第 12 章 Arduino 简介 223 


问 axes 模块 ， 设 置 图 形 的 x 和 y 限制 。x 限制 是 样本 数 ，y 限制 为 1023， 因 为 它 是 
模拟 值 范围 的 上 限 。 


在 @ 行 ， 取 得 matplotlib 的 figure 模块 ， 其 中 包含 所 有 的 绘图 元 素 。 在 @ 行 , 访 





















































在 @ 行 和 @ 行 ， 创 建 两 个 空白 行 对 象 (a0 和 al)， 我 们 将 它们 传递 给 animation 




















类 来 设置 回调 ， 为 每 一 行 提供 坐标 。 然 后 ， 在 @ 行 ， 传 入 在 每 个 动画 步 又 中 要 调用 
的 analogPlot update0 方 法 ， 来 设置 动画 。 我 们 还 指定 了 调用 该 方法 的 参数 ， 以 及 以 










































































毫秒 为 单位 的 时 间 间 隔 ， 这 里 是 20。 在 @ 行 ， 调 用 pltshow0) 来 启动 动画 。 




















程序 的 main0 方 法 也 是 用 Python 模块 argparse 来 支持 命令 行 选项 的 地 方 。 


# create parser 

parser = argparse.ArgumentParser(description="LDR serial") 
# add expected arguments 

parser.add argument('--port', dest='port', required=True) 
parser.add argument('--N', dest='maxLen', required=False) 


# parse args 
args = parser.parse_args() 


strPort = args.port 


# plot parameters 
maxLen = 100 
if args.maxLen: 
maxLen = int(args.maxLen) 











--port 参数 是 必需 的 。 它 告诉 程序 接收 数据 的 串口 名 称 CE Arduino IDE 中 的 
ToolsD Serial Port 下 找到 )。maxLen 参数 是 可 选 的 ， 用 于 设置 一 次 绘制 的 点 数 〈 默 
认 值 为 100 个 样本 )。 
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下 面 是 这 个 项 目的 完整 Python 代码 。 也 可 以 从 https://github.com/electronut/ 








pp/tree/master/arduino-ldr/ldr.py 下 载 完 整 的 代码 。 


import serial, argparse 

from collections import deque 

import matplotlib.pyplot as plt 

import matplotlib.animation as animation 


# plot class 
class AnalogPlot: 


# constructor 
def | init__(self, strPort, maxLen): 
# open serial port 
self.ser = serial.Serial(strPort, 9600) 


self.aOVals = deque([0.0]*maxLen) 
self.aiVals = deque([0.0]*maxLen) 
self.maxLen = maxLen 
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# add data 

def add(self, data): 
assert(len(data) == 2) 
self.addToDeq(self.aOVals, data[0]) 
self .addToDeq(self.a1Vals, data[1]) 


# add to deque; pop oldest value 
def addToDeq(self, buf, val): 
buf .pop() 
buf .appendleft (val) 


# update plot 
def update(self, frameNum, aO, a1): 
try: 
line = self.ser.readline() 
data = [float(val) for val in line.split()] 
# print data 
if(len(data) -- 2): 
self.add(data) 
a0.set data(range(self.maxLen), self.a0Vals) 
a1.set_data(range(self.maxLen), self.aiVals) 
except: 
pass 


return a0, a1 


# clean up 

def close(self): 
# close serial 
self.ser.flush() 
self.ser.close() 


# main() function 
def main(): 


# create parser 

parser = argparse.ArgumentParser(description="LDR serial") 
# add expected arguments 

parser.add_argument('--port', dest='port', required=True) 
parser.add_argument('--N', dest='maxLen', required=False) 
# parse args 

args = parser.parse_args() 


#strPort = '/dev/tty.usbserial-A7006Yqh' 
strPort = args.port 


print('reading from serial port %s...' % strPort) 


# plot parameters 
maxLen = 100 
if args.maxLen: 
maxLen = int(args.maxLen) 


# create plot object 
analogPlot = AnalogPlot(strPort, maxLen) 


print('plotting data...') 
# set up animation 


fig = plt.figure() 
ax = plt.axes(xlim-(0, maxLen), ylim=(0, 1023) ) 
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80, = ax.plot([], []) 

ai, = ax.plot([], []) 

anim = animation.FuncAnimation(fig, analogPlot.update, 
fargs=(a0, a1), interval=20) 


# show plot 
plt.show() 


# clean up 
analogPlot.close() 


print('exiting.') 
# call main 


if name == ' gain 
main() 





运行 程序 




















要 测试 该 程序 ， 请 组 装 LDR 电路 ,将 Arduino 连接 到 计算 机 ， 上 传 程序 ， 然 后 
运行 Python 代码 。 
$ python3 --port /dev/tty.usbmodem411 ldr.py 
图 12-5 展示 了 程序 的 输出 示例 ， 有 具体 来 说 ， 是 LDR 暴露 在 光 下 然后 覆盖 时 生 
成 的 图 。 从 图 中 可 以 看 出 ， 当 LDR 的 电阻 变化 时 ，Arduino 读 取 的 模拟 电压 也 发 生 
变化 。 中 心 的 高 峰 发 生 在 我 迅速 将 手 放 在 LDR 上 时 ， 右 侧 平坦 部 分 发 生 在 我 较 慢 
地 移 过 手 时 。 
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#}/0/0 +) =| 8/8 
图 12-5 光敏 绘图 程序 的 运行 
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这 两 个 LDR 具有 不 同 的 电阻 特性 ， 这 就 是 两 条 线 不 完全 重合 的 原因 ， 但 是 你 
可 以 看 到 ， 它 们 以 相同 的 方式 对 光 强 的 变化 做 出 反应 。 

















12.8 小结 


yE. 


这 个 项 目 介 绍 了 微 控制 器 和 Arduino 平台 的 世界 。 我 们 学 习 了 Arduino 编程 语 
法 以 及 如 何 将 程序 上 传 到 Arduino， 还 学 习 了 如 何 从 Arduino 引 脚 读 取 模拟 值 ， 并 
创建 一 个 简单 的 LDR 电路 。 此 外 , 我 们 学 习 了 如 何 通过 串口 从 Arduino 发 送 数据 ， 
并 使 用 Python 从 计算 机 读 取 数据 ， 还 学 习 了 使 用 实时 滚动 图 和 matplotlib 让 数据 
可 视 化 。 
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12.9 实验 





请 尝试 对 Arduino 项 目 进行 如 下 修改 。 

1. 在 程序 中 ， 图 形 从 左 到 右 滚 动 ， 换 言 之 ， 新 值 从 左边 进来 时 ， 较 老 的 值 向 
右 移动 。 请 反 转 滚动 方向 ， 使 图 形 从 右 向 左 移 动 。 

2. Arduino 代码 定期 读 取 模拟 值 ， 并 将 它们 发 送 到 串口 。 输 入 数据 可 能 在 某 些 
类 型 的 传感器 中 存在 波动 ， 常 见 的 做 法 是 应 用 某 种 类 型 的 滤波 ， 从 而 平滑 数据 。 请 
实现 LDR 数据 的 均值 策略 (提示 : 保存 每 个 LDR 读 取 的 N 个 模拟 值 的 移动 平均 值 ， 
平均 值 应 定期 发 送 到 串口 。 减 少 循环 中 的 delay0， 以 便 更 快 地 读 取 值 。 均 值 图 比 原 
台 图 更 平滑 吗 ? 尝试 不 同 的 N 值 ， 看 看 会 发 生 什么 )。 
3. 传感器 电路 中 有 两 个 LDR。 保持 这 些 LDR 在 良好 的 光源 下 ， 从 它们 上 面 用 
手 扫 过 。 你 应 该 看 到 图 形 的 急剧 变化 : 一 个 LDR 曲线 在 另 一 个 之 前 变化 ， 因 为 它 
首先 被 遮挡 。 可 以 用 这 些 信 息 来 检测 手 的 运动 方向 吗 ? 这 是 一 个 基本 的 手势 检测 项 
H Gm: LDR 中 图 形 的 急剧 变化 发 生 在 不 同 的 时 间 ， 说 明 哪 个 LDR 先 被 遮蔽 ， 
从 而 给 出 手 的 运动 方向 )。 
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激光 音乐 秀 


























在 第 12 章 中 ， 我 们 学 习 了 Arduino 的 基础 知识 ， 这 很 适 
合 与 底层 电子 设备 接口 。 在 本 项 目 中 ， 我 们 将 利用 Arduino 
搭建 硬件 ， 通 过 音频 信号 产生 有 趣 的 激光 图 案 。 这 一 次 ， 
Python 会 承担 更 重 的 任务 。 除 了 处 理 串口 通信 之 外 ， 它 还 会 























































































































基于 实时 音频 数据 进行 计算 ， 并 利用 该 数据 来 调整 激光 显示 
设备 中 的 电机 。 
出 于 这 些 目 的 ， 请 将 激光 当 作 一 束 强 烈 的 光束 ， 即 使 通过 很 大 距离 投射 ， 它 仍 












































保持 聚焦 在 一 个 微小 的 点 上 。 这 种 聚焦 是 可 能 的 ， 因 为 光束 被 组 织 成 光波 只 沿 一 个 
方向 行进 ， 且 彼此 同 相 。 这 个 项 目 将 用 一 个 便宜 的 、 容 易 获 得 的 激光 笔 来 创建 激光 
图 案 ， 与 音乐 同步 (或 任何 音频 输入 )。 我 们 用 激光 笔 和 两 个 连接 到 电机 的 旋转 镜 ， 
来 构建 生成 有 趣 图 案 的 硬件 。 我 们 用 Arduino 设置 电机 的 方向 和 旋转 速度 ， 利 用 
Python 通过 串口 来 控制 。Python 程序 将 读 取 音频 输入 ， 分 析 它 ， 并 将 它 转 换 为 电机 
速度 和 方向 数据 来 控制 电机 。 我 们 还 将 学 习 如 何 设置 电机 的 速度 和 方向 ， 让 图 案 与 
音乐 同步 。 

本 项 目 将 进一步 提升 你 的 Arduino 和 Python 知识 。 以 下 是 将 要 介绍 的 一 些 
主题 : 


。 用 激光 和 两 个 旋转 镜 产 生 有 趣 的 图 案 ; 
















































































































































































































































































用 快速 傅立叶 变换 从 信和 号 中 获得 频率 信息 ; 
用 numpy 计算 快速 傅 里 时 变换 ; 

用 pyaudio 读 取 音频 数据 ; 
在 计算 机 和 Arduino 之 间 设 置 串口 通信 ; 
用 Arduino 驱动 电机 。 





























13.1 用 激光 产生 图 案 
为 了 在 此 项 目 中 生成 激光 图 案 ， 我 们 用 激光 笔 和 两 个 镜子 连接 到 两 个 小 型 直流 
电机 的 轴 上 ， 如 图 13-1 所 示 。 如 果 你 平面 镜 〈 反 射 镜 A) 的 表面 照射 激光 ， 即 使 电 
机 正在 旋转 ， 投 影 的 反射 将 保持 为 一 个 点 。 因 为 激光 器 的 反射 平面 垂直 于 电机 的 旋 
转轴 ， 所 以 就 像 镜子 根本 不 旋转 一 样 。 
现在 ， 假 设 镜子 与 轴 成 一 定 角度 连接 ， 如 图 13-1 右 侧 所 示 (反射 镜 BO. “HH 
旋转 时 ， 投 影 点 的 轨迹 是 一 个 覃 圆 ， 而 且 如 果 电 机 旋转 足够 快 ， 观 察 者 会 感觉 到 移 
动 点 是 连续 的 形状 。 













































































































































































反射 镜 A 下 个 一 下 反射 镜 B 





13-1 平面 镜 (镜子 A) 反射 单个 点 。 倾 针 的 镜子 〈 镜 子 B ) 的 反射 在 电动 机 旋转 时 产生 一 个 贺 


如 果 安 排 镜 子 ， 使 从 镜子 A 反射 的 光 投 影 到 镜子 B E, RBA? 现在 当 电 
机 A 和 电机 B 旋转 时 ， 由 反射 点 产生 的 图 案 将 是 电机 A 和 电机 B 的 两 个 旋转 运 
动 的 组 合 ， 产 生出 有 趣 的 图 案 ， 如 图 13-2 所 示 。 

产生 的 图 案 将 取决 于 两 个 电机 的 旋转 速度 和 旋转 方向 ， 但 是 它们 类 似 于 在 第 2 
章 中 探讨 的 万 花 尺 产生 的 长 短 辐 圆 内 旋 轮 线 。 



































13.1.1 电机 控制 
我 们 用 Arduino 来 控制 电机 的 速度 和 方向 。 这 种 设置 要 小 心 , 确保 它 可 以 接受 
外 机 相对 较 高 的 电压 ， 因 为 Arduino 只 能 承担 这 么 大 的 电流 ， 否 则 会 损坏 。 可 以 用 
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13-3 Ca) PPR 的 SparkFun TB6612FNG 外 设 “ 分 线 (breakout)” 板 来 保护 Arduino, 
简化 设计 并 缩短 开发 时 间 。 利 用 分 线 板 从 Arduino 同时 控制 两 个 电机 。 





图 13-2 反射 激光 离开 两 面 旋 转 的 、 倾 儿 的 镜子 ， 产 生 了 有 趣 的 复杂 图 案 


TTA) 
vec t^t 
eno 2 
ne1 ^79 


neg2 TA 
: ge2* 
TB6612FNC ' pei «7 


Breakout 


eup.* 72 





(a) (b) 
13-3 SparkFun 电机 驱动 器 1A 双 通 道 TB6612FNG 


图 13-3 b) 展示 了 分 线 板 的 焊接 背面 。 引 脚 名 称 中 的 A 和 B 表示 两 个 电机 。 
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IN 引 脚 控制 电机 的 方向 ，01 和 02 引 脚 为 电机 供电 ，PWM 引 脚 控制 电机 速度 。 通 
过 写 入 这 些 引 脚 , 你 可 以 控制 每 个 电机 的 旋转 方向 和 速度 , 而 这 正 是 本 项 目 需要 的 。 























注意 可 以 用 任何 你 熟悉 的 电机 控制 电路 替换 该 分 线 板 部 分 ， 只 要 适当 地 修改 
Arduino 程序 即 可 。 





13.1.2 (Rik Ite 
因为 本 项 目的 最 终 目标 是 基于 音频 输入 控制 电机 速度 ， 所 以 需要 能 够 分 析 音 频 
的 频率 。 
回顾 一 下 第 4 章 ， 来 自 乐 器 的 音调 是 多 种 频率 或 泛音 的 混合 。 事 实 上， 任何 声 
音 都 可 以 用 傅立叶 变换 分 解 为 成 分 频率 。 将 傅 里 叶 变 换 应 用 于 数字 信号 时 ， 结 果 称 
为 离散 傅 里 叶 变换 (DFT)， 因 为 数字 信号 由 许多 离散 样本 组 成 。 在 本 项 目 中 ,我 们 
用 Python 来 实现 快速 傅立叶 变换 (FFT) 算法 ， 计 算 DFT (在 本 章 中 ， 我 将 使 用 
FFT 来 指 代 算 法 和 结果 )。 

下 面 是 一 个 简单 的 FFT 示例 。 图 13-4 展示 了 一 个 只 包含 两 个 正弦 波 的 信号 ， 
下 面 是 对 应 的 FFT。 上 面 的 波 可 以 用 以 下 等 式 表示 ， 是 两 个 波 相 加 : 

y(t) = 4sin(2710t) + 2.5sin(2730t) 


















































































































































































































































9s 5000 10000 15000 20000 25000 
frequency 


图 13-4 从 音乐 中 记录 的 音频 信号 (上 ) 及 相应 的 FFT CT) 


请 注意 第 一 个 波 的 表达 式 中 的 4 和 10: 4 是 波 的 振幅 ，10 是 波 的 频率 〈 以 赫 效 
为 单位 )。 同 时 ， 第 二 个 波 的 振幅 是 2.5， 频 率 是 30。 
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FFT 揭示 了 波 的 分 量 频率 及 其 相对 振幅 ， 显 示 峰 值 在 10 Hz 和 30 Hz。 第 一 个 
峰值 的 强度 约 为 第 二 个 峰值 的 强度 的 两 倍 。 

现在 来 看 一 个 更 复杂 的 例子 。 图 13-5 展示 了 上 面 的 音频 信号 ,以 及 下 面相 应 的 
FFT. 
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13-5 FFT 算法 利用 振幅 信号 (上 ) 计算 其 分 量 频率 (下 ) 


音频 输入 (或 信号 ) 处 在 “时 域 ” 中 ， 因 为 振幅 数据 随时 间 变 化 。FFT 处 在 “ 频 
域 ” 中 。 注 意图 13-5 中 ，FFT 显示 了 一 系列 峰值 ， 显 示 了 信号 中 各 种 频率 的 强度 。 

要 计算 FFT， 需 要 一 组 样本 。 样 本 数 的 选择 是 有 点 随意 的 ， 但 是 小 的 样本 规模 
不 能 给 出 信号 频率 特征 的 良好 图 景 ， 还 可 能 意味 着 更 大 的 计算 量 ， 因 为 每 秒 需要 计 
更 多 的 FFT。 另 一 方面 ， 过 大 的 样本 规模 让 信和 号 的 变化 平均 化 ， 因 此 不 会 得 到 信 
号 的 “实时 ”频率 响应 。 对 于 本 项 目 采用 的 44100Hz 的 采样 率 ，2048 的 样本 大 小 
表示 大 约 0.046 秒 的 数据 。 

对 于 本 项 目 , 我 们 需要 将 音频 数据 分 解 成 它 的 组 成 频率 , 并 用 该 信息 控制 电机 。 
首先 , 将 频率 范围 (以 Hz 为 单位 ) 分 成 3 个 频段 : [0,100]、 [100,1000] 和 [1000, 2500]. 
我 们 将 计算 每 个 频带 的 平均 振幅 ， 每 个 值 将 不 同 程度 地 影响 电机 和 产生 的 激光 图 
案 ， 如 下 所 示 : 
。 低频 平均 振幅 的 变化 将 影响 第 一 个 电机 的 速度 ; 

。 中 频 平 均 振幅 的 变化 将 影响 第 二 个 电机 的 速度 ; 
。 高 频 峰 值 高 于 某 个 闵 值 时 ， 第 一 个 电机 将 改变 方向 。 


frequency 























































































































































































































13.2 ”所 需 模块 


以 下 是 构建 此 项 目 所 需 物品 的 列表 : 
。 一文 小 激光 笔 ; 
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两 个 直流 电动 机 ， 如 用 于 小 玩具 (额定 为 9V) 的 电机 ; 

两 个 小 镜子 ， 直 径 约 2.54 厘米 或 更 小 ; 

SparkFun 电机 驱动 器 LA 双 通道 TB6612FNG; 

Arduino Uno 或 类 似 板 卡 ; 

连接 的 电线 ( 单 蕊 连接 线 ， 两 侧 的 公 插 针 工 作 良 好 ); 

四 节 AA 电池 组 ; 

一 些 乐 高 模块 ， 将 电机 和 激光 笔 从 安装 板 上 抬 起 ， 使 镜子 可 以 自由 旋转 ; 
一 个 矩形 的 纸板 或 丙烯 酸 树 脂 板 ， 约 20.3 厘米 X15.2 厘米 ， 以 安装 硬件 ; 
一 把 热 胶 枪 ; 

烙铁 。 












































13.2.1 搭建 激光 秀 

第 一 件 事 是 将 镜子 连接 到 电机 。 反 射 镜 必须 与 电机 轴 成 一 个 小 角度 。 要 安装 镜 
子 ， 将 其 面 朝 下 放置 在 平坦 的 表面 上 ， 并 在 中 心 滴 一 滴 热 胶 。 小 心地 将 电机 轴 浸 入 
胶水 中 ， 使 其 垂直 于 镜子 ， 直 到 胶水 硬化 “如 图 13-6 所 示 )。 要 测试 它 ， 就 用 手 旋 
转 镜子 ， 同 时 用 激光 笔 照 射 它 。 你 应 该 发 现 反射 的 激光 点 投射 在 平坦 表面 上 时 ， 移 
动 轨迹 是 一 个 椭圆 中 。 对 第 二 面 镜 子 也 一 样 操作 。 

































































图 13-6 以 微小 角度 将 反射 镜 连 接 到 每 个 电机 轴 
对 准 镜子 
接 下 来 ， 将 激光 笔 与 反射 镜 对 准 ， 使 激光 从 反射 镜 A 反射 到 B， 如 图 13-7 所 
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示 。 确保 在 反射 镜 A 的 整个 旋转 范围 内 , 来 自 反 射 镜 A 的 反射 激光 保持 在 反射 镜 也 
的 圆周 内 (这 需要 一 些 尝 试 ， 可 能 会 犯 些 错 )。 要 测试 ， 请 手动 旋转 反射 镜 A.X 
外 ， 确 保 在 两 个 反射 镜 的 旋转 范围 内 ,反射 镜 B 的 位 置 让 它 反 射 的 光 落 在 一 个 平面 
上 《如 墙 上 )。 




















图 13-7 激光 笔 和 反射 镜 的 对 准 





调整 时 ， 需 要 保持 激光 笔 打 开 。 如 果 激 光 笔 有 一 个 开启 按钮 ， 请 用 胶带 让 
它 保持 打开 (或 者 参见 13.8 节 ， 了 解 更 优雅 的 控制 激光 笔 电 源 的 方法 ). 





对 镜子 的 位 置 感到 满意 后 ， 将 激光 笔 和 两 个 带 有 镜子 的 电机 用 热 熔 胶 粘 到 3 个 
一 样 的 乐高 模块 上 ， 将 它们 升 起 ， 让 它们 能 够 自由 旋转 。 接 下 来 ， 将 模块 放 在 安装 
板 上 ， 当 你 对 它们 的 摆 放 感到 满意 时 ， 通 过 用 铅笔 记录 它们 的 边缘 ， 标 记 每 个 模块 
的 位 置 。 然 后 将 模块 粘 在 板 上 。 

为 电机 供电 


如 果 电 机 没有 附带 连接 到 它们 的 端子 上 的 电线 (大 多 数 没有 )， 就 将 电线 焊接 
到 两 个 端子 ， 确 保留 出 足够 的 电线 (例如 15 厘米 )， 以 便 将 电机 连接 到 电机 驱动 板 
FE. 电机 由 电池 组 中 的 四 节 AA 电池 供电 , 可 以 用 热 熔 胶 将 它 粘 在 安装 板 的 背面 ， 
如 图 13-8 所 示 。 

现在 用 手 旋转 两 个 镜子 来 测试 硬件 ， 同 时 用 激光 照射 它们 。 如 果 足 够 快 地 旋转 
它们 ， 应 该 看 到 一 些 有 趣 的 图 案 ， 才 见 结果 的 样子 ! 
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13-8 将 电池 组 固定 在 安装 板 背 面 


13.2.2 ”连接 电机 驱动 器 
本 项 目 用 Arduino 通过 Sparkfun 电机 驱动 器 (TB6612FNG ) 来 控制 电机 。 我 不 

会 详细 介绍 这 个 板 卡 的 工作 原理 ， 但 如 果 你 好 奇 ， 可 以 从 了 解 “ 理 桥 ”开始 ， 这 是 

一 种 常见 的 电路 设计 ， 用 “金属 氧化 物 半导体 场 效应 晶体 管 (MOSFET)” 来 控制 



























































电机 。 




















现在 将 电机 连接 到 SparkFun H 



































电机 驱动 器 和 Arduino。 有 不 少 电线 要 连接 ， 如 表 


13-1 所 示 。 一 个 电机 标记 为 A， 另 一 个 为 B， 在 接线 时 遵守 这 个 惯例 。 











表 13-1 SparkFun 电机 驱动 器 到 Arduino 的 接线 








从 至 

Arduino Digital Pin 12 TB6612FNG Pin BIN2 
Arduino Digital Pin 11 TB6612FNG Pin BIN1 
Arduino Digital Pin 10 TB6612FNG Pin STBY 
Arduino Digital Pin 9 TB6612FNG Pin AIN1 
Arduino Digital Pin 8 TB6612FNG Pin AIN2 
Arduino Digital Pin 5 TB6612FNG Pin PWMB 
Arduino Digital Pin 3 TB6612FNG Pin PWMA 
Arduino 5V Pin TB6612FNG Pin VCC 
Arduino GND TB6612FNG Pin GND 
Arduino GND Battery Pack GND (- ) 
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BER 





从 至 

Battery Pack VCC (+) TB6612FNG Pin VM 
Motor #1 Connector #1 (polarity doesn’ t matter) TB6612FNG Pin A01 
Motor #1 Connector #2 (polarity doesn’ t matter) TB6612FNG Pin A02 
Motor #2 Connector #1 (polarity doesn’ t matter) TB6612FNG Pin BO! 
Motor #2 Connector #2 (polarity doesn’ t matter) TB6612FNG Pin B02 


Arduino USB connector 


图 13-9 展示 了 所 有 接线 。 


计算 机 的 USB 口 





图 13-9 ”完全 连 好 线 的 激光 秀 装 置 


现在 来 看 看 Arduino 程序 。 





13.3 ”Arduino 程序 


程序 开始 时 ， 设 置 Arduino 的 数字 输出 引 脚 。 然 后 ， 在 主 循环 中 ， 从 串口 读 入 








数据 ， 并 将 数据 转换 为 需要 发 送 到 
电机 的 速度 和 方向 控制 。 


机 驱动 器 板 卡 的 参数 。 我 们 还 要 了 解 如 何 实现 
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13.3.1 MÆ Arduino 数字 输出 引 脚 


首先 , 根据 表 13-1 将 Arduino 数字 引 脚 英 射 到 电机 驱动 器 上 的 引 脚 ， 并 将 引 脚 


设置 为 输出 。 


// motor A connected to A01 and A02 
// motor B connected to BO1 and BO2 


© 


// Motor A 


int PWMA = 3; //speed control 
9; //direction 
8; //direction 


int AIN1 
int AIN2 


int PWMB 


// Motor B 
int BIN1 = 


© 


void setup(){ 

e pinMode(STBY, 
pinMode(PWMA, 
pinMode(AIN1, 
pinMode(AIN2, 
pinMode (PWMB, 
pinMode(BIN1, 
pinMode(BIN2, 


// initialize 


从 @ 行 到 @ 行 , 将 Arduino 5| 





(脉冲 调制 A) 321 


int STBY = 10; //standby 


5; //speed control 
11; //direction 
int BIN2 = 12; //direction 


OUTPUT) ; 


OUTPUT) ; 
OUTPUT) ; 
OUTPUT) ; 


OUTPUT) ; 
OUTPUT) ; 
OUTPUT) ; 


serial communication 
o Serial.begin(9600); 

















ATE 4 RI RS 80] AL a as S| A. ll a, PWMA 
HI FLL A 的 速度 ， 并 分 配给 Arduino 4] fil 


3. PWM 是 为 设备 供 


电 的 一 种 方式 ， 通 过 发 送 快速 打开 和 关闭 的 数字 脉冲 ， 让 器 件 “ 看 到 ”连续 的 电 


压 。 数 字 脉 冲 接 通 的 时 间 部 分 称 为 “ 占 空 比 ”， 以 百分比 
分 比 ,可 以 为 设备 提供 不 同 的 功率 水 平 。 PWM 通常 


速度 。 








然后 ， 在 目 行 调用 
上 。 在 @@ 行 ， 开 始 串 口 

















mind 


13.3.2 Æ 


































































































信息 来 设置 控制 电机 的 驱动 板 的 数字 输出 。 
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表示 。 通 过 更 改 这 个 百 
j 于 控制 可 调 光 LED 和 电机 


setup0 方 法 ， 在 后 续 几 行 中 ， 将 所 有 7 个 数字 引 脚 设置 为 输 


通信 ， 读 取 由 Arduino 上 的 计算 机 发 送 的 串 行 数据 。 

















程序 中 的 主 循环 等 待 串 行 数据 到 达 ， 解 析 它 以 提取 电机 速度 和 方向 ， 并 利用 该 





// main loop that reads the motor data sent by laser.py 
void loop() 


// data sent is of the form 'H' 
if (Serial.available() >= 5) ( 
if(Serial.read() == 'H') { 

// read the next 4 bytes 
byte s1 = Serial.read(); 


(header), speed!, 


byte d1 = Serial.read(); 
byte s2 = Serial.read(); 
byte d2 = Serial.read(); 


// stop the motor if both speeds are O 
if(s1 == 0 && s2 == 0) ( 

















dirt, speed2, dir2 

















stop(); 
} 
else { 
// set the motors' speed and direction 
move(O, s1, d1); 
move(1, s2, d2); 
} 
// slight pause for 20 ms 
delay(20); 
} 
else { 
// if there is invalid data, stop the motors 
stop(); 
} 
} 
else { 
// if there is no data, pause for 250 ms 
delay (250) ; 
} 
} 
电机 控制 数据 以 5 个 字 节 为 一 组 发 送 : H 后 跟 4 个 单字 节 数 字 sl. dl. s2 和 
d2， 表 示 电 机 的 速度 和 方向 。 由 于 串 行 数据 连 续 输 入 ， 所 以 在 @ 行 ， 检 查 并 确保 已 











收 到 至 少 5 个 字 节 。 如 果 没 有 ， 就 延迟 250 毫秒 @， 并 尝试 在 下 








取 数 据 。 






































个 周期 中 再 次 读 




















在 @ 行 ， 检 查 读 入 的 第 一 个 字 节 是 一 个 H， 以 确保 在 一 组 正确 的 控制 数据 的 开 
台 处 ， 接 下 来 的 4 个 字 节 是 期 望 的 数据 。 如 果 不 是 ， 就 在 @ 行 停止 电机 ， 























可 能 因 传输 或 连接 错 ; 





吴 而 被 损坏 。 














从 目 行 开始 ,程序 读 取 两 个 电机 的 速度 和 方向 数据 



































因为 数据 





。 如 果 两 个 电机 速度 都 设置 为 


零 ， 就 停止 电机 @。 如 果 不 是 ， 则 在 @ 行 用 move() 方 法 将 速度 和 方向 值 分 配给 电机 。 




















在 @ 行 ， 在 数据 读 取 中 添加 一 个 
下 面 是 用 于 设置 电机 速度 和 方向 的 move() 方 法 : 


// set motor speed and direction 
// motor: A -> 1, B -> 0 

// direction: 1/0 
void move(int motor, 


{ 





























i 


























int speed, int direction) 











小 延迟 ， 让 电机 能 跟 上 ， 确 保 没 有 太 快 地 读 入 数据 。 
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// disable standby 


o digitalWrite(STBY, HIGH); 

e boolean inPin1 = LOW; 
boolean inPin2 - HIGH; 

e if(direction -- 1)( 


inPini = HIGH; 
inPin2 - LOW; 
} 


if(motor == 1){ 
o digitalWrite(AIN1, inPin1) ; 
digitalWrite(AIN2, inPin2) ; 
analogWrite(PWMA, speed); 


} 
else{ 

e digitalWrite(BIN1, inPin1); 
digitalWrite(BIN2, inPin2); 
analogWrite(PWMB, speed); 

} 


} 


电机 驱动 器 具有 待机 模式 ， 以 便 在 电机 关闭 时 节省 电力 。 在 @ 行 ， 通 过 写 入 
HIGH 到 待机 引 脚 ， 退 出 待机 。 在 四 行 ， 定 义 两 个 布尔 变量 ， 它 们 确定 电机 的 旋转 
Jil]. fEO T, WR direction 参数 设置 为 1， 则 翻转 这 些 变量 的 值 ， 这 让 你 在 下 面 
的 代码 中 切换 电机 的 方向 。 

在 @ 行 ， 为 电机 A 设置 引 脚 AINI, AIN2 和 PWMA。 引 脚 AINI 和 AN? 控 
制 电 机 的 方向 , 根据 需要 ,我 们 用 Arduino 的 digitalWrite() 方 法 将 一 个 引 脚 设置 为 
HIGH (1)， 一 个 设置 为 LOW (0)。 对 于 引 脚 PWMA， 我 们 发 送 PWM 信号 ， 如 
前 所 述 ， 这 可 以 控制 电机 的 速度 。 要 控制 PWM 的 值 ， 可 以 用 analogWrite() 方 法 将 
范围 [0,255] 内 的 值 写 入 Arduino 输出 引 脚 〈 不 同 的 是 ，digitalWrite() 方 法 只 人 允许 将 
1 或 0 写 入 输出 引 脚 )。 

在 @ 行 ， 设 置 电机 了 的 引 脚 。 
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13.3.3 ”停止 电机 
要 停止 电机 ， 将 LOW 写 入 电机 驱动 器 的 待机 引 脚 。 


void stop(){ 
//enable standby 
digitalWrite(STBY, LOW); 























} 


13.4. Python 代码 


现在 来 看 看 在 计算 机 上 运行 的 Python 代码 。 这 段 代码 完成 了 繁重 的 工作 : 它 读 入 
音频 ， 计 算 FFT， 并 发 送 串 行 数据 到 Arduino。 可 以 在 13.5 节 中 找到 完整 的 项 目 代 码 。 
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13.4.1 选择 


p = pyaudio.PyAudio() 


尘 音频 设备 
首先 ， 需 要 利用 pyaudio 模块 读 入 音频 数据 。 初 始 化 pyaudio 模块 如 下 : 
























































接 下 来 ,可 以 用 pyaudio 中 的 辅助 函数 访问 计算 机 的 音频 输入 设备 getmputDevice0) 
方法 的 代码 如 下 所 示 : 


# get pyaudio input device 
def getInputDevice(p): 


ooo 





index = None 
nDevices = p.get device count() 
print('Found %d devices. Select input device:' % nDevices) 
# print all devices found 
for i in range(nDevices): 
deviceInfo = p.get_device_info_by_index(i) 
devName = deviceInfo['name'] 
print("%d: %s" % (i, devName) ) 
# get user selection 
try: 
# convert to integer 
index = int(input() ) 
except: 
pass 


# print the name of the chosen device 

if index is not None: 
devName = p.get device info by index(index)["name"] 
print("Input device chosen: %s" % devName) 

return index 


在 @ 行 ， 将 index JERAN None QZ index 是 @ 行 的 函数 返回 值 ， 如 果 返 匠 
























































为 None， AUR URINE 在 @ 行 ， 用 get device count()77 15:3 HX 
计算 机 上 音频 设备 的 数量 ， 包 括 所 有 音频 硬件 ， 如 麦克 风 、 线 路 输入 或 线路 输出 。 


然后 遍历 所 有 找到 的 设备 ， 获 取 每 个 设备 的 信息 。 










































































自行 的 get_device_info_by_index() Ph BU [nl —-*4 其 中 包含 每 个 音频 设备 












































的 各 种 特征 信息 ， 但 我 们 只 想 查 看 设备 的 名 称 ， 因为 我 们 正在 查找 输入 设备 。 在 @ 


行 ， 保 存 设备 名 称 ， 在 @@ 行 ， 打 印 出 设备 的 索引 和 名 称 。 在 @ 行 ， 利 用 inputO 方 法 



























































读 入 用 户 的 选择 ， 将 读 入 的 字符 串 转换 为 整数 索引 。 在 @ 行 ， 这 个 选 定 的 索引 从 函 
数 返回 。 





13.4.2 ”从 输入 设备 读 取 数 据 





选择 输入 设备 后 , 需要 从 中 读 取 数 据 。 为 此 , 我 们 先 打开 音频 流 , 如 下 所 示 GE 











意 ， 所 有 的 代码 在 while 循环 中 连续 执行 )。 
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# set FFT sample length 


o fftLen = 2**11 
# set sample rate 
e sampleRate - 44100 
print('opening stream...') 
e stream = p.open(format = pyaudio.paInt16, 


channels = 1, 

rate = sampleRate, 

input = True, 

frames per buffer = fftLen, 
input device index - inputIndex) 


在 @ 行 ， 将 FFT 缓冲 区 的 长 度 〈 用 于 计算 FFT 的 音频 采样 数 ) 设置 为 2048 (是 
211, FFT 算法 针对 2 的 索 进 行 了 优化 )。 然 后 ， 将 pyaudio 的 采样 率 设置 为 44100, 
即 44.1 kHz @， 这 是 CD 质量 录音 的 标准 。 

接 下 来 ， 打 开 pyaudio 流 @， 并 指定 几 个 选项 : 

e pyaudio.paInt16 表示 读 取 的 数据 作为 16 位 整数 ; 

e channels 设置 为 1， 因 为 我 们 将 音频 作为 单个 频道 读 取 ; 

。 rate 设置 为 选 定 的 采样 速率 44100 Hz; 

。 input 设置 为 True; 

e frames per buffer 设置 为 FFT ŽW XK; 

。 input device index 设置 为 我 们 在 getmputDevice() 方 法 中 选择 的 设备 。 

























































































13.4.3 计算 数据 流 的 FFT 
以 下 是 从 流 中 读 取 数据 的 代码 : 

















# read a chunk of data 
o data - stream.read(fftLen) 
# convert the data to a numpy array 
e dataArray = numpy.frombuffer(data, dtype-numpy.int16) 


企 @ 行 ， 从 音频 输入 流 读 取 最 近 的 fftLen 样本 。 然 后 在 @ 行 ， 将 该 数据 转换 为 
16 位 整数 numpy 数组 。 
现在 计算 这 个 数据 的 FFT。 


# get FFT of data 














o fftVals = numpy.fft.rfft(dataArray)*2.0/fftLen 
# get absolute values of complex numbers 
e fftVals - numpy.abs(fftVals) 









































(EO (T. H numpy fft 模块 中 的 rtft() 方 法 ， 计 算 numpy 数组 中 的 值 的 FFT。 
该 方法 接受 由 “实数 ”( 如 音频 数据 ) 组 成 的 信号 并 计算 FFT， 通 常 结果 是 一 组 
“复数 ”。2.0/fftLen 是 归 一 化 因子 ， 用 来 将 FFT 值 映射 到 希望 的 范围 。 然 后 ， 因 
为 ffft0 方 法 返回 复数 ， 所 以 使 用 numpy 的 abs0 方 法 @ 来 获取 这 些 复数 的 大 小 ， 


ID 


已 是 实数 。 
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13.4.4 从 FFT 值 提 取 频 率 信息 
接 下 来 ， 从 FFT 值 中 提取 相关 的 频率 信息 。 


# average 3 frequency bands: 0-100 Hz, 100-1000 Hz, and 1000-2500 Hz 

levels = [numpy.sum(fftVals[0:100])/100, 
numpy.sum(fftVals[100:1000])/900, 
numpy.sum(fftVals[1000:2500])/1500] 


为 了 分 析 音 频 信号 ， 我 们 将 频率 范围 分 为 3 个 频段 : 0 至 100Hz. 100 至 1000 
Hz 和 1000 至 2500 Hz。 我 们 最 感 兴趣 的 是 较 低 的 低音 频段 (0-100 Hz) 和 中 音 
(100-1000 Hz) 频段 ， 分 别 大 致 对 应 于 一 首 歌 曲 中 的 节拍 和 人 声 。 对 于 每 个 范围 


我 们 在 代码 中 用 numpy.sum0 方 法 计算 平均 FFT 值 。 

























































































13.4.5 ”将 频率 转换 为 电机 速度 和 方向 
现在 将 该 频率 信息 转换 为 电机 速度 和 方向 。 


# 'H' (header), speed1, dir1, speed2, dir2 




















o vals = [ord('H'), 100, 1, 100, 1] 
# Speed1 

e vals[1] = int(5*levels[0]) % 255 
# speed2 

e vals[3] = int(100 + levels[1]) % 255 
# dir 
d1 = 0 

o if levels[2] > 0.1: 

di = 1 

vals[2] = d1 

e vals[4] = 0 











在 @ 行 , 初始 化 要 发 送 到 Arduino 的 电机 速度 和 方向 值 的 列表 (5 个 字 节 , MA 
开始 ， 前 面 讨论 过 )。 用 内 置 ord0 函 数 将 字符 串 转 换 为 整数 ， 然 后 将 3 个 频带 的 平 
均值 转换 为 电机 速度 和 方向 ， 填 充 该 列表 。 
























































注意 这 部 分 确实 是 自由 发 挥 : 没有 特别 优雅 的 规则 来 管理 这 些 转换 。 这 些 值 随 
着 音频 信号 而 不 断 变 化 ， 你 提出 的 任何 方法 都 可 以 改变 电机 速度 ， 并 随 音乐 一 
起 影响 激光 模式 。 只 需 确 保 转换 将 电机 速度 设置 在 [0,255] 范 围 内 ， 并 且 方 向 总 
是 设置 为 1 或 0。 我 选择 的 方法 只 是 基于 试验 和 错误 , 我 在 播放 各 种 类 型 的 音乐 
时 观察 FFT 值 。 
































在 @ 行 从 最 低频 率 范围 获取 值 , 放大 5 fi. 转换 为 整数 ,并 用 取 模 运算 符 (%) 
角 保 该 值 位 于 [0,255] 范 围 内 。 该 值 控 制 第 一 电机 的 速度 。 在 @ 行 ， 将 中 间 频 率 值 加 
上 100， 并 放 在 [0,255] 范 围 内 。 该 值 控制 第 二 电机 的 速度 。 

















zu 
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的 值 直 





然后 ， 在 @ 行 ， 只 要 最 高 频率 范围 
机 B 的 方向 保持 为 08《〈 通 过 尝试 和 错误 ， 我 发 现 ， 
但 我 建议 你 改变 这 些 值 ， 并 创建 自己 的 转换 。 
























































ENTRE 0.1, X 
这 些 方法 产生 
这 里 没有 错 ie 的 答案 )。 


























切换 
很 好 的 图 








HAL A 方向 。 
案 变 化 ， 


; iu 



































































































































































































































13.4.6 ”测试 电机 设置 
在 用 实时 音频 流 测试 硬件 之 前 ， 先 检查 电机 设置 。 这 里 展示 的 autoTestO 函 数 就 
是 做 这 件 事 的 : 
# automatic test for sending motor speeds 
def autoTest(ser): 
print('starting automatic test...') 
try: 
while True: 
# for each direction combination 
o for dr in [(0, 0), (1, 0), (0, 1), (1, 1)]: 
# for a range of speeds 
e for j in range(25, 180, 10): 
e for i in range(25, 180, 10): 
o vals = [ord('H'), i, dr[0], j, dr[1]] 
e print(vals[1:]) 
e data = struct.pack('BBBBB', *vals) 
[7] ser.write(data) 
sleep(0.1) 
except KeyboardInterrupt: 
print('exiting...') 
# shut off motors 
e vals = [ord('H'), 0, 1, 0, 1] 
data = struct.pack('BBBBB', *vals) 
ser.write(data) 
ser.close() 
该 方法 通过 改变 每 个 电机 的 速度 和 方向 ， 让 两 个 电机 在 一 定 范 围 内 运动 。 因 为 
每 个 电动 机 的 方向 可 以 是 顺 时 针 或 逆 时 针 ， 所 以 在 @ 行 的 外 层 循环 中 表示 4 个 这 样 
的 组 合 。 对 于 每 种 组 合 ，@ 行 和 @ 行 的 循环 以 不 同 的 速度 运转 电机 。 
注意 我 使 用 范围 (25，180，10 )， 这 意味 着 速度 从 25 KF) 180, KA 10. A 
没有 用 电机 的 完整 运动 范围 [0，255]， 因 为 电机 很 少 转速 低 于 25， 而 200 以 上 
的 转速 真 的 很 快 
在 @ 行 ， 生 成 5 字 节 的 电机 数据 值 ， 在 @ 行 ， 打 印 它 们 的 方向 和 速度 值 〈 使 用 
Python FERURI vals [1: ] 将 获得 除 列表 中 的 第 一 个 元 素 之 外 的 所 有 内 容 )。 
在 @ 行 ， 将 电机 数据 打包 到 字 节 数组 中 ， 并 在 @ 行 将 其 写 入 串口 。 按 Ctrl-C 键 
中 断 这 个 测试 ， 在 @ 行 通过 清理 来 处 理 这 个 异常 ， 停 止 电机 并 关闭 串口 ， 像 你 这 样 
负责 的 程序 员 都 会 这 么 做 。 








244 Python 极 客 项 目 编程 


13.4.7 


13.4.8 


命令 行 选 项 

















与 以 前 的 项 目 一 样 ， 可 以 用 argparse 模块 来 解析 程序 的 命令 行 参 数 。 























# main method 
def main(): 

# parse arguments 

parser = argparse.ArgumentParser(description-'Analyzes audio input 
sends motor control information via serial port') 

# add arguments 


and 


parser.add argument('--port', dest-'serial port name', required=True) 


parser.add argument('--mtest', action-'store true', default-False) 
parser.add argument('--atest', action-'store true', default-False) 
args = parser.parse args() 

























































































下 面 是 main0 方 法 中 解析 命令 行 选项 后 发 生 的 情况 : 


# open serial port 
strPort = args.serial_port_name 
print('opening ', strPort) 
o ser = serial.Serial(strPort, 9600) 
if args.mtest: 
manualTest (ser) 
elif args.atest: 
autoTest(ser) 
else: 
e fftLive(ser) 


在 @ 行 ， 利 用 pySerial He AJZFEBUSETIBAITJT— 8 EB. 8 
波 特 率 设置 为 每 秒 9000 位 。 如 果 没 有 使 用 其 他 命令 参数 (--atest 
@ 行 继续 音频 处 理 和 FFT 计算 ， 这 封装 在 fftLive() 方 法 中 。 

































































手动 测试 








在 这 段 代 码 中 ， 串 口 是 必 需 的 命令 行 选 项 。 还 有 两 个 可 选 的 命令 行 选项 : 一 个 
用 于 自动 测试 (前 面 介绍 过 )， 男 一 个 用 于 手动 测试 ( 稍 后 将 讨论 )。 





a 行 通信 的 速度 或 
或 --mtest)， 则 在 


y 


这 个 手动 测试 允许 你 输入 特定 的 电机 方向 和 速度 ， 以 便 看 到 它们 对 激光 图 案 的 




















u 





影响 。 


# manual test of motor direction and speeds 
def manualTest(ser): 
print('starting manual test...') 
try: 
while True: 
print('enter motor control info such as < 100 1 120 0 >') 


o strIn = raw input() 
e vals = [int(val) for val in strIn.split()[:4]] 
e vals.insert(0, ord('H')) 
o data - struct.pack('BBBBB', *vals) 
e ser.write(data) 
except: 
print('exiting...') 


# shut off the motors 
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[5] vals = [ord('H'), 0, 1, 0, 1] 
data = struct.pack('BBBBB', *vals) 
ser.write (data) 
ser.close() 


在 @ 行 ， 用 raw_input0 方 法 等 待 ， 直 到 用 户 在 命令 提示 符 下 输入 值 。 预 期 输入 
的 形式 为 100 1 120 0, 表示 电机 A 的 速度 和 方向 , 然后 是 电机 B 的 速度 和 方向 。 在 
@ 行 ， 将 字符 串 解 析 为 整数 列表 。 在 @ 行 ， 插 入 一 个 “H” 构 成 完整 的 电机 数据 ， 
在 @ 行 和 @ 行 ， 打 包 此 数据 并 通过 串口 以 预期 的 格式 发 送 。 如 果 用 户 用 Ctrl-C 中 断 
测试 〈 或 者 发 生 任何 异常 )， 就 在 @ 行 完成 清理 工作 ， 正 常 关 闭 电机 和 串口 。 
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13.5 ”完整 的 Python 代码 


下 面 是 本 项 目的 完整 的 Python 代码 。 也 可 以 在 https://github.com/electronut/pp/ 
tree/master/arduino-laser/laser.py 找到 它 。 









































import sys, serial, struct 
import pyaudio 

import numpy 

import math 

from time import sleep 
import argparse 


# manual test of motor direction speeds 
def manualTest(ser): 
print('staring manual test...') 
try: 
while True: 
print('enter motor control info: eg. < 100 1 120 0 >') 
strIn = raw input() 
vals = [int(val) for val in strIn.split()[:4]] 
vals.insert(0, ord('H')) 
data = struct.pack('BBBBB', *vals) 
ser.write(data) 
except: 
print('exiting...') 
# shut off motors 
vals = [ord('H'), 0, 1, 0, 1] 
data = struct.pack('BBBBB', *vals) 
ser.write(data) 
ser.close() 


# automatic test for sending motor speeds 
def autoTest(ser): 
print('staring automatic test...') 
try: 
while True: 
# for each direction combination 
for dr in [(0, 0), (1, 0), (0, 1), (1, 1)]: 
# for a range of speeds 
for j in range(25, 180, 10): 
for i in range(25, 180, 10): 
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vals = [ord('H'), i, dr[0], j, dr[1]] 
print(vals[1:]) 

data = struct.pack('BBBBB', *vals) 
ser.write (data) 


sleep(0.1) 
except KeyboardInterrupt: 
print('exiting...') 


# shut off motors 

vals = [ord('H'), 0, 1, 0, 1] 

data - struct.pack('BBBBB', *vals) 
ser.write(data) 

ser.close() 


# get pyaudio input device 
def getInputDevice(p): 
index - None 
nDevices - p.get device count() 
print('Found %d devices. Select input device:' % nDevices) 
# print all devices found 
for i in range(nDevices): 
deviceInfo - p.get device info by index(i) 
devName = deviceInfo['name'] 
print("%d: %s" % (i, devName)) 
# get user selection 
try: 
# convert to integer 
index = int(input()) 
except: 
pass 


# print the name of the chosen device 

if index is not None: 
devName = p.get device info by index(index)["name"] 
print("Input device chosen: %s" % devName) 

return index 


# FFT of live audio 

def fftLive(ser) 
# initialize pyaudio 
p = pyaudio.PyAudio() 


# get pyAudio input device index 
inputIndex = getInputDevice(p) 


# set FFT sample length 
fftLen = 2**11 

# set sample rate 
sampleRate - 44100 


print('opening stream...') 

stream = p.open(format = pyaudio.paInti6, 
channels = 1, 
rate = sampleRate, 
input = True, 
frames per buffer = fftLen, 
input device index - inputIndex) 
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try: 
while True: 

# read a chunk of data 

data = stream.read(fftLen) 

# convert to numpy array 

dataArray = numpy.frombuffer(data, dtype=numpy.int16) 

# get FFT of data 

fftVals = numpy.fft.rfft(dataArray)*2.0/fftLen 

# get absolute values of complex numbers 

fftVals - numpy.abs(fftVals) 

# average 3 frequency bands: 0-100 Hz, 100-1000 Hz and 1000-2500 Hz 

levels = [numpy.sum(fftVals[0:100])/100, 
numpy.sum(fftVals[100:1000] ) /900, 
numpy.sum(fftVals[1000:2500])/1500] 


# the data sent is of the form: 
# 'H' (header), speed1, diri, speed2, dir2 
vals = [ord('H'), 100, 1, 100, 1] 


# speed1 

vals[1] = int(5*levels[0]) % 255 

# speed2 

vals[3] = int(100 + levels[1]) % 255 


# dir 

di = 0 

if levels[2] > 0.1: 
di = 1 

vals[2] = d1 

vals[4] = 0 

# pack data 


data = struct.pack('BBBBB', *vals) 
# write data to serial port 
ser.write(data) 
# a slight pause 
sleep(0.001) 
except KeyboardInterrupt: 
print('stopping...') 
finally: 
print('cleaning up') 
stream.close() 
p.terminate() 
# shut off motors 
vals = [ord('H'), 0, 1, 0, 1] 
data = struct.pack('BBBBB', *vals) 
ser.write(data) 
# close serial 
ser.flush() 
ser.close() 


# main method 
def main(): 

# parse arguments 

parser = argparse.ArgumentParser(description-'Analyzes audio input and 
sends motor control information via serial port') 

# add arguments 
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parser.add argument('--port', dest-'serial port name', required=True) 
parser.add argument('--mtest', action-'store true', default-False) 
parser.add argument('--atest', action-'store true', default-False) 
args = parser.parse args() 


# open serial port 
strPort - args.serial port name 
print('opening ', strPort) 
ser - serial.Serial(strPort, 9600) 
if args.mtest: 
manualTest (ser) 
elif args.atest: 
autoTest(ser) 
else: 
fftLive(ser) 


# call main function 


if name == main ': 
main() 





13.6 “运行 程序 
为 了 测试 本 项 目 ， 请 组 装 硬件 ， 将 Arduino 连接 到 计算 机 ， 并 将 电机 驱动 程序 
代码 上 传 到 Arduino。 确 保 电池 组 已 连接 ， 激 光 笔 已 打开 并 投射 在 墙壁 这 样 的 平坦 
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表面 上 。 我 建议 首先 通过 运行 以 下 程序 来 测试 激光 显示 部 分 (不 要 忘记 更 改 串 口 字 
符 串 以 符合 你 的 计算 机 )1 

















$ python3 laser.py --port /dev/tty.usbmodem411 --atest 
(‘opening ', '/dev/tty.usbmodem1411') 

staring automatic test... 

[25, 0, 25, 0 
[35, 0, 25, 0 
[45, 0, 25, 0] 





























该 测试 通过 速度 和 方向 的 各 种 组 合 来 运转 两 个 电机 。 你 应 该 看 到 投射 到 墙 上 的 
不 同 激光 图 案 。 要 停止 程序 和 电机 ， 请 按 Ctrl-C. 

如 果 测 斌 成功， 就 可 以 开始 真正 的 激光 秀 了 。 在 计算 机 上 开始 播放 你 喜欢 的 音 
乐 ， 然 后 运行 程序 如 下 。( 同 样 ， 注 意 串 口 字符 串 !) 
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$ python3 laser.py --port /dev/tty.usbmodem411 
(‘opening ', '/dev/tty.usbmodem1411') 

Found 4 devices. Select input device: 

0: Built-in Microph 

1: Built-in Output 

2: BoomDevice 

3: AirParrot 

0 

Input device chosen: Built-in Microph 

opening stream... 
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该 看 到 激光 秀 产生 了 许多 有 趣 的 图 案 ， 随 着 音乐 和 时 间 变 化 ， 如 图 13-10 


= 
长 
i 











图 13-10 激光 秀 的 完整 布线 和 投影 在 墙 上 的 图 案 


13.7 ^d 


本 章 通过 构建 一 个 较 复 杂 的 项 目 ,， 来 提升 你 的 Python 和 Arduino 技能 。 你 学 习 
了 如 何 使 用 Python 和 Arduino 控制 电机 ， 用 numpy 来 获得 音频 数据 的 FFT， 控 制 
串口 通信 ， 甚 至 是 激光 ! 






































13.8 ”实验 
下 面 是 修改 此 项 目的 一 些 方法 。 
1. 该 程序 采用 一 种 自由 发 挥 的 方案 将 FFT 值 转换 为 电机 速度 和 方向 数据 。 请 
尝试 修改 此 方案 。 例 如 ， 尝 试 使 用 不 同 的 频带 和 标准 来 改变 电机 的 方向 。 
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2. 在 本 项 目 中 ， 从 音频 信号 收集 的 频率 信息 被 转换 为 电机 速度 和 方向 。 请 尝 
试 根据 音乐 的 整体 “节奏 ”或 音量 来 让 电机 运动 。 为 此 , 你 可 以 计算 信号 幅度 的 “ 均 
方 根 (RMS)” 值 。 该 计算 类 似 于 FFT 计算 。 读 入 一 组 音频 数据 并 放 入 numpy 数组 
x 后 ， 可 以 按 如 下 方式 计算 RMS fü: 


rms = numpy.sqrt(numpy.mean(x**2)) 


此 外 ， 回 忆 一 下 ， 项 目 中 振幅 表示 为 16 位 有 符号 整数 ， 其 最 大 值 为 32768 (一 
个 要 记 住 的 有 用 数字 ,用 于 标准 化 )。 用 这 个 RMS 振幅 与 FFT 结合 ， 让 激光 图 案 产 
生 更 大 的 变化 。 

在 项 目 中 ， 我 们 比较 朴素 地 用 了 一 些 胶带 来 保持 激光 笔 的 打开 状态 ， 测 试 并 进 
行 硬件 设置 。 能 找到 更 好 的 方法 来 控制 激光 吗 ?请 阅读 光 隔 离 器 和 继电器 的 相关 材 
料 "”， 这 是 可 以 打开 和 关闭 外 部 电路 的 设备 。 要 使 用 这 些 设备 ， 首 先 需要 改造 激光 
笔 ， 让 它 可 以 通过 外 部 开关 切换 。 一 种 方法 是 永久 地 将 激光 笔 的 按钮 粘 接 到 ON 位 
置 ， 取 出 电池 ， 并 将 两 个 引线 焊接 到 电池 触 点 上 。 现 在 就 可 以 用 这 些 电线 和 激光 笔 
的 电池 手动 打开 和 关闭 激光 笔 。 接 下 来 ， 通 过 继电器 或 光 隔 离 器 连接 激光 笔 ， 并 使 
Arduino 上 的 数字 引 脚 将 其 打开 ， 用 数字 开关 替换 此 方案 。 如 果 使 用 光 隔离 器 ， 可 
以 直接 用 Arduino 切 换 激光 开关 。 如 果 使 用 继电器 ， 还 需要 一 个 驱动 器 ，i 通常 是 一 个 
简单 的 晶体 管 电 路 。 
有 这 样 的 设置 后 ,请 添加 一 些 代 码 ， 让 Python 程序 运行 时 ， 发 送 一 个 串 行 命令 
到 Arduino， 在 开始 之 前 打开 激光 笔 。 
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GD “Relays and Optoisolators," What-When-How, http://what-when-how.com/805 1 -microcontroller/relays-and-optoisolators/ o 
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基于 树 等 派 的 天 气 监 控 器 





当 你 发 现 需要 更 多 的 计算 能 力 或 外 设 文 持 的 时 候 ， 如 USB 
或 高 清晰 度 多 媒体 接口 (HDMI) 视频 , 你 已 经 离开 了 像 Arduino 
这 样 的 微 控 制 器 领域 , 进入 了 计算 机 领域 。 树 侮 派 (Raspberry Pi) 
是 一 个 小 型 计算 机 ,可 以 很 好 地 执行 这 样 的 高 级 任务 , 尤其 是 与 
Arduino 相 比 。 
像 Arduino 一 样 ， 树 侮 派 在 许多 有 趣 的 项 目 中 使 用 。 虽 然 可 
以 放 在 手掌 中 ， 但 它 是 一 个 完整 的 计算 机 (可 以 连接 一 个 显示 器 和 键盘 )， 这 让 它 
在 教师 和 创造 者 中 很 受 欢迎 。 
本 章 将 用 树 莓 派 以 及 温度 和 湿度 传感器 (DHT11)， 来 构建 基于 Web 的 温度 和 
湿度 监控 系统 。 在 树 莹 派 上 运行 的 代码 将 启动 Bottle Web 服务 器 , 监听 传 入 的 连接 。 
当 你 访问 本 地 网 络 上 的 树 蕉 派 的 Internet 协议 CIP) 地 址 时 ，Bottle 服务 器 会 提供 包 
含 天 气 数据 图 表 的 网 页 。 树 每 上 的 处 理 程序 将 与 DHTII 传感器 通信 ， 取 得 数据 ， 
并 返回 给 客户 程序 ， 客 户 程序 用 flot 库 在 浏览 器 中 绘制 传感器 数据 。 我 们 还 会 为 连 
接 到 树 侮 派 的 发 光 二 极 管 (LED) 提供 基于 Web 的 控制 〈 这 只 是 为 了 演示 如 何 用 树 
侮 派 通过 Web 来 控制 外 部 设备 )。 






































































































































































































































































































































注意 这 个 项 目 使 用 Python 2.7. PAIK LAY Raspbian 操作 系统 提供 了 Python 2.7 
(在 shell 上 运行 python ) 和 Python 3 (在 shell 上 运行 python3 )。 编 写 的 代码 与 
两 者 兼容 。 





14.1 硬件 





像 现 在 销售 的 所 有 笔记 本 电脑 或 台式 机 一 样 ， 树 侮 派 具有 中 央 处 理 单元 
CCPU)、 随 机 存 取 存 储 器 CRAM). USB 端口 、 视 频 输 出 、 音 频 输出 和 网 络 连接 。 
但 与 大 多 数 计算 机 不 同 ， 树 莓 派 很 便宜 : 约 35 美元 。 此 外 ， 由 于 板 载 的 通用 输入 / 
4H CGPIO) 引 脚 ， 树 大 派 可 以 轻松 与 外 部 硬件 接口 ， 让 它 成 为 各 种 嵌入 式 硬 件 项 
目的 理想 选择 。 我 们 将 用 DHTI11 温度 和 湿度 传感器 连接 它 ， 监 控 环 境 。 











14.1.1 DHT11 温 湿度 传感器 
DHT11( 见 图 14-1) 是 一 种 测量 温度 和 湿度 的 常用 传感器 。 它 有 4 个 引 脚 : VDD 
(+), GND (-)、DATA， 第 4 个 不 使 用 。DATA 引 脚 连接 到 微 控 制 器 (在 本 例 中 为 
树 侮 派 )， 输 入 和 输出 都 通过 该 引 脚 。 我 们 将 用 Adafruit Python 库 Adafruit_Python_ 
DHT 与 DHT11 通信 ， 取 得 温度 和 湿度 数据 。 
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14.1.2 WER 

写作 本 书 时 ， 有 3 种 型 号 的 树 侮 派 : Raspberry Pi 1 Model A+, Raspberry Pi 1 
Model B + 和 Raspberry Pi 2 Model B. 。 这 个 项 目 使 用 了 较 老 的 Raspberry Pi Model B 
Rev 2, 但 项 目 中 使 用 的 引 脚 号 码 在 所 有 型 号 中 都 兼容 , 并且 代码 能 在 所 有 型 号 上 工 
作 ， 无 需 更 改 。 

图 14-2 展示 了 一 个 树 莓 派 B 型 计算 机 ， 它 有 两 个 USB 端口 ， 一 个 HDMI 连接 
器 ， 一 个 复合 视频 输出 插 孔 ， 一 个 音频 输出 插 孔 ， 一 个 用 于 供电 的 微型 USB 端口 ， 
一 个 以 太 网 端口 和 26 个 GPIO 引 脚 ， 引 脚 排 成 两 列 ， 每 列 13 针 。 板 的 底 侧 还 有 SD 
卡 插 槽 (未 显示 )。 树 莓 派 使 用 Broadcom BCM2835 芯片 ,该 芯片 有 一 个 ARM CPU, 
运行 频率 为 700 MHz， 功 耗 非常 低 (这 就 是 为 什么 树 莓 派 不 像 台 式 计算 机 那样 ， 需 
要 巨大 的 散热 片 来 冷却 它 )。B 型 还 有 512MB 的 SDRAM。 这 些 细节 大 多 数 对 于 
这 个 项 目 并 不 重要 , 但 如 果 你 想 用 最 新 袖珍 计算 机 的 所 有 规格 给 人 留 下 深刻 印象 ， 
这 些 细节 可 能 很 方便 。 














































































































14-2 MARES B 


14.1.3 RERE 
与 Arduino 不 同 ， 不 能 将 树 蔡 派 插入 计算 机 并 开始 编码 。 作 为 一 个 完备 的 计 
算 机 ， 树 莓 派 需要 一 个 操作 系统 和 一 些 外 设 。 至 少 ， 建 议 使 用 如 图 14-3 所 示 的 
外 设 。 
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。 一 张 8GB 或 更 高 容量 的 SD 卡 ， 具 有 合适 的 操作 系统 ; 

。 与 树 侮 派 兼容 的 USB Wi-Fi 适配器 ; 

。 与 树 侮 派 兼容 的 电源 《官方 建议 是 使 用 SV 1200 mA 电源 ， 如 果 需 要 使 用 所 有 
USB 端口 ， 则 使 用 SV 2500 mA 电源 ); 

。 保护 宝贵 的 树 莓 派 的 盒子 ; 

。 键盘 和 鼠标 〈 方 便 起 见 ， 请 考虑 仅 占用 一 个 USB 端口 的 无 线 组 合 ); 

。 复合 视频 电缆 或 HDMI 电缆 〈 关 于 树 莓 派 使 用 HDMI 电缆 的 详细 信息 ， 请 参 
阅 附录 C. 




































































































































































Pi case 


Pi-compatible power 
supply 


Pi-compatible USB 
Wi-Fi adapter 





14-3 推荐 的 树 莓 派 外 设 套件 





注意 购买 前 , 请 务必 检查 已 知 与 Pi 兼容 的 外 围 设备 列表 , 网 址 在 http://elinuxorg/ 
RPI_VerifiedPeripherals. 








14.2 ”安装 和 配置 软件 


现在 可 以 设置 树 侮 派 并 准备 编写 Python 了 。 下 一 节 将 简要 介绍 所 需 的 步骤 , 但 
你 应 该 在 安装 前 ， 看 看 Raspberry Pi Foundation 的 “Getting Started wit ”页 
你 应 该 在 安 看 看 Raspberry Pi Found 的 “Getting Started with NOOBS” 页 
上 提供 的 设置 视频 (http://www.raspberrypi.org/help/noobs-setup/)。 
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14.2.1 操作 系统 
树 蔡 派 的 操作 系统 和 文件 将 驻 留 在 外 部 SD 卡 上 。 虽 然 有 几 个 操作 系统 可 以 选 
择 ， 但 我 建议 安装 Raspbian。 操 作 系 统 需 要 以 特定 的 方式 安装 ， 我 不 会 在 这 里 介 
细节 (细节 可 能 会 改变 ), 而 是 请 你 去 看 在 Linux wiki lf) *RPi Easy SD Card Setup”, 
网 址 是 http://elinux.org/RPi_Easy_SD_Card_Setup， 或 者 同一 链接 中 的 “Using 
NOOBS”， 它 更 适合 初学 者 。 






















































































14.2.2 ”初始 配置 
安装 操作 系统 后 ， 就 可 以 首次 启动 了 。 插 入 格式 化 的 SD 卡 ， 将 复合 视频 电 统 通 
接 到 电视 或 显示 器 ， 连 接 键 盘 和 鼠标 ， 然 后 将 树 莓 派 连接 到 电源 。 树 侮 派 启动 时 ， 一 
个 叫 raspi-config 的 程序 应 该 启动 ， 你 应 该 看 到 各 种 配置 选项 (可 以 在 Raspberry Pi 
Foundation 网 站 上 找到 raspi-config 的 文档 https://www.raspberrypi.org/documentation/ 
configuration/raspi-config.md )。 修 改 配 置 如 下 : 
1. 选择 Expand Filesystem 以 使 用 完整 的 SD 卡 ; 
2. 选择 Enable Boot to Desktop/Scratch， 然 后 选择 Desktop; 
3. 选择 Change Time Zone， 并 在 Internationalization Options 下 设置 时 区 ; 
4. 转 到 Advanced Options 并 启用 Overscan; 
5. 转 到 SSH， 通 过 选择 Enable or Disable SSH Server 选项 ， 在 Advanced Options 
菜单 中 启用 远程 命令 行 访问 。 


现在 选择 Fnish， 树 侮 派 应 该 重新 启动 并 显示 桌面 。 
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14.2.8 Wi-Fi 设置 

我 们 将 在 此 项 目 中 用 无 线 网 络 连接 树 侮 派 。 假 设 安 装 了 兼容 的 Wi-Fi 适配器 (请 
先 查 阅 http://elinux.org/ 网 站 )，Raspbian 应 该 在 插入 时 自动 识别 适配器 。 假 设 一 切 
正常 ， 我 们 将 设置 一 个 静态 IP 地 址 ， 即 利用 内 置 的 Nano 编辑 器 来 编辑 网 络 配置 文 
fF (Nano 有 一 个 极 简单 的 UI， 熟 悉 它 可 能 需要 一 点 时 间 。 最 重要 的 事情 是 记得 按 
Ctrl-X 并 输入 Yes， 保 存 文件 并 退出 )。 

我 们 将 在 终端 中 运行 命令 。 打 开 LXTerminal 〈 它 应 该 与 Raspbian 一 同安 装 )， 
并 输入 以 下 内 容 : 
$ sudo nano /etc/network/interfaces 

该 命令 将 打开 interfaces 文件 ， 我 们 用 它 来 配置 网 络 设置 ， 如 下 所 示 : 


auto lo 
















































































































































































iface lo inet loopback 
iface ethO inet dhcp 
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allow-hotplug wlanO 

iface wlanO inet manual 

wpa-roam /etc/wpa supplicant/wpa supplicant.conf 
iface default inet static 

address 192.x.x.x 

netmask 255.255.255.0 

gateway 192.x.x.x 


添加 或 修改 文件 末尾 的 address. netmask 和 gateway 等 行 ， 以 适合 本 地 网 络 。 

输入 网 络 的 网 络 掩 码 ( 可 能 为 255.255.255.0), 输入 网 络 的 网 关 ( 在 Linux 上 从 Linux 
终端 运行 ifconfig。 在 Windows 上 按 Windows 和 R 键 ， 然 后 运行 ipconfig/all。 或 者 
在 OS X 上 选择 System Preferences->Network)， 给 树 蔡 派 一 个 静态 网 络 IP 地 址 ， 它 
不 同 于 网 络 上 任何 其 他 设备 的 全 地址 。 

现在 使 用 WiFi Config 实用 程序 , 让 树 董 派 连接 Wi-Fi 网 络 。 你 应 该 在 桌面 上 看 
到 一 个 快捷 方式 〈 如 果 遇 到 困难 ， 请 尝试 https://learn.adafruit.com/ 上 的 Adafruit Zt 
程 。 如 果 一 切 顺利 ， 树 莓 派 应 该 能 用 内 置 的 浏览 器 Midori 连 上 因特网 )。 
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14.2.4 ”设置 编程 环境 
接 下 来 ， 我 们 安装 开发 环境 ， 包 括 与 外 部 硬件 通信 所 需 的 RPi.GPIO 包 ，Bottle 
Web 框架 以 及 在 Raspberry Pi 上 安装 其 他 Python 包 所 需 的 工具 。 确保 已 连接 到 因 特 
网 ， 并 在 终端 中 运行 以 下 命令 ， 每 次 一 条 : 
sudo apt-get update 
sudo apt-get install python-setuptools 
sudo apt-get install python-dev 
sudo apt-get install python-rpi.gpio 
sudo easy_install bottle 
现在 ， 从 http:Wwww.flotcharts.org/ 下 载 最 新 版 本 的 flot JavaScript 绘图 库 ， 将 它 
展开 以 创建 flot 目录 ， 并 将 此 目录 复制 到 你 的 程序 所 在 的 文件 夹 中 。 
$ wget http://www.flotcharts.org/downloads/flot-x.zip 


$ unzip flot-x.zip 
$ mv flot myProjectDir/ 


接 下 来 ,在 终端 中 运行 以 下 命令 ,安装 Adafruit Python DHT /# Chttps://github.com/ 
adafruit/Adafruit Python _DHT/)， 你 将 用 它 从 连接 到 树 莓 派 的 DHTI11 传感器 取得 
数据 : 
$ git clone https://github.com/adafruit/Adafruit Python DHT.git 


$ cd Adafruit_Python_DHT 
$ sudo python setup.py install 


树 董 派 现 在 应 该 已 经 设置 好 ， 我 们 已 经 有 了 构建 天 气 监 视 程 序 所 需 的 全 部 
软件 。 
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14.2.5 ”通过 SSH 连接 
与 连接 显示 器 、 用 鼠标 和 键盘 控制 它 相 比 ， 通 过 桌面 或 笔记 本 电脑 登录 树 莓 派 
是 更 容易 的 方法 。Linux 和 OS X 内 置 了 这 种 支持 ， 即 Secure Shell (SSH)。 如 果 你 
的 是 Windows， 请 安装 PuTTY LBS AAI o 
以 下 列表 展示 了 典型 的 SSH 会 话 : 
@ moksha:~ mahesh$ ssh pi@192.168.4.32 
@ pi@192.168.4.32's password: 
e pieraspberrypi - $ whoami 
err -$ 
在 这 个 会 话 中 ， 在 @ 行 ， 输 入 ssh 命令 、 默 认 用 户 名 〈pi) 以 及 下 地 址 ， 形 如 
ssh username@ip_address， 从 我 的 计算 机 登录 到 树 侮 派 。 输 入 ssh 时 外， 会 提示 输入 
密码 。 默 认 密码 为 raspberry。 
你 认为 登录 树 莓 派 成 功 后 ， 请 输入 whoami 命令 上 日 。 如 果 响 应 是 Pt， 如 前 所 示 ， 
则 已 经 正确 登录 。 






















































































































































































注意 更 改 树 莽 派 的 用 户 名 和 和 密码， 让 它 更 安全 ， 这 是 一 个 好 主意 。 有 关 使 用 树 
莓 派 远程 操作 的 更 多 提示 ， 请 参阅 附录 C。 





14.2.6 Web 框架 Bottle 
要 通过 Web 界面 监视 和 控制 树 侮 派 ， 需 要 让 它 运 行 一 个 Web 服务 器 。 我 们 将 
使 用 Bottle， 它 是 一 个 具有 简单 界面 的 Python Web 框架 (实际 上 ， 整 个 库 由 名 为 
bottle.py 的 单个 源 文件 组 成 )。 以 下 是 用 Bottle 提供 一 个 简单 网 页 所 需 的 代码 : 


from bottle import route, run 






















































































@route('/hello') 
def hello(): 
return "Hello Bottle World!" 


run(host='192.168.x.x', port=xxxx, debug= 


这 段 代 码 用 Python 装饰 器 @route 定义 了 一 条 路 由 ， 代 表 一 个 URL 或 路 径 ， 客 

户 端 用 它 来 发 送 数据 请 求 。 定 义 的 路 由 调用 路 由 函数 ， 返 回 一 个 字符 串 。run(0 方 法 
启动 Bottle 服务 器 ,现在 可 以 接受 来 自 客户 端的 连接 (请 务必 提供 你 自己 的 卫 地 址 
和 端口 号 )。 请 注意 ， 我 已 将 debug 标记 设置 为 True， 这 样 更 容易 诊断 问题 )。 
在 连接 到 本 地 网 络 的 任何 计算 机 上 打开 浏览 器 ， 输 入 http:/192.168.4.4: 
8080/hello。 连 接 到 树 侮 派 ，Bottle 应 该 提供 一 个 网 页 ， 包 含 “Hello Bottle World ! ". 
只 需 几 行 代 码 ， 就 可 以 创建 一 个 Web 服务 器 。 

客户 端 将 利用 异步 JavaScript 和 XML (AJAX) 框架 ， 向 服务 器 〈 运 行 在 树 莓 派 


rue) 




































































































































































951438. ”基于 树 莓 派 的 天 气 监 控 器 259 





EKI Bottle) 发 出 请 求 。 为 了 让 AJAX 调用 易于 编写 ， 我 们 将 使 用 流行 的 jQuery 库 。 


Python 装饰 器 
Python 中 的 装饰 器 采用 @ 语 法 ， 它 将 一 个 函数 作为 参数 ， 并 返回 另 一 个 函数 . 
饰 器 提供 了 一 种 方便 的 方式 ， 用 另 一 个 函数 来 “包装 ”一 个 函数 。 例 如 ， ae 


@wrapper 
def myFunc(): 
return 'hi' 


相当 于 执行 以 下 操作 : 


myFunc = wrapper (myFunc) 


HR Python 中 的 一 等 对 象 ， 可 以 像 变量 一 样 传递 。 








14.2.7 用 flot 绘制 

现在 让 我 们 来 看 看 如 何 绘制 数据 。flot 库 有 一 个 易于 使 用 的 强大 API， 让 我 们 
用 最 少 的 代码 来 创建 漂亮 的 图 形 。 基 本 上 ,我 们 设置 一 些 超 文本 标记 语言 (HTML) 
来 保存 一 个 图 表 ， 并 提供 值 的 一 个 数组 来 绘图 ，Flot 处 理 其 余 工 作 ， 如 这 个 例子 所 
示 《 可 以 在 本 书 代 码 库 的 simple-flot.html 文件 中 找到 这 段 代 码 )。 


«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8'» 
<title>SimpleFlot</title> 
© <style> 
.demo-placeholder { 
width: 80%; 
height: 80%; 
} 
</style> 
e «script language="javascript" type="text/javascript" 
src="flot/jquery.js"></script> 
<script language="javascript" type="text/javascript" 
src="flot/jquery.flot.js"></script> 
<script language-"javascript" type="text/javascript"> 
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e $(document).ready(function() { 
// create plot 
o var data = []; 
for(var i = 0; i < 500; i ++) ( 
e data.push([i, Math.exp(-i/100)*Math.sin(Math.PI*i/10)]); 
} 
e var plot = $.plot("#placeholder", [data]); 
n5 
«[script» 
</head> 
<body> 


<h3>A Simple Flot Plot</h3> 
«div class="demo-container"> 
[7] «div id="placeholder" class-"demo-placeholder"»«/div» 
«[div» 
</body> 
</html> 
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在 @ 行 , 定义 一 个 CSS 类 (demo-placeholder)， 设 置 占 位 符 元 素 的 宽度 和 高 度 ， 
来 保存 绘图 〈 它 将 在 文档 的 主体 中 定义 )。 在 @@ 行 ， 声 明 在 此 HTML 文件 中 将 使 用 
的 库 的 JavaScript 文件 : jquery.js 和 flotjs “请 注意 ，jQuery 5 flot 捆绑 在 一 起 ， 因 
此 不 需要 单独 下 载 它 。 此 外 ， 请 确保 将 顶层 flot 目录 放 在 包含 此 项 目 所 有 源 代码 的 
同一 目录 中 )。 

接 下 来 ,用 JavaScript 生成 要 绘制 的 值 。 在 @ 行 ,用 jQuery 7715$(document).readyO 
定义 一 个 函数 ， 一 旦 HTML 文件 加 载 了 ， 浏 览 器 就 执行 它 。 在 该 函数 内 部 ， 在 @ 行 ， 
声明 一 个 空 的 JavaScript 数组 ， 然 后 循环 500 X, XE yl Anse. 
每 个 值 表示 这 个 有 趣 函 数 〈 选 择 有 点 随意 ) 的 x 和 >》 坐标。 


x9) =e sin{ 于， 的 范围 是 00.500 






















































































在 @ 行 ， 从 flot 库 调用 plot0) 来 绘图 。 在 @ 行 ，plot0 函 数 将 包含 绘图 的 HTML 
元 素 (placeholder 元 素 ) 的 id 作为 输入 。 在 浏览 器 中 加 载 生成 的 HTML 文件 时 ， 
应 该 看 到 如 图 14-4 所 示 的 图 形 。 
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E 14-4 用 flot 创建 的 示例 图 形 
这 里 使 用 了 flot 的 默认 设置 , 但 你 可 以 通过 调整 颜色 , 使 用 数据 点 而 不 是 线条 ， 
添加 图 例 和 标题 ， 采 用 交互 式 绘 图 ， 以 及 更 多 的 方式 来 定制 flot 绘图 (在 14.4.2 节 ， 
会 看 到 设计 天 气 数据 的 图 表 时 如 何 操作 )。 





















































14.2.8 关闭 树 莓 派 

不 要 突然 断 开 运 行 的 树 蔡 派 的 电源 ， 否 则 可 能 会 损坏 文件 系统 ， 让 树 荃 派 无 法 
启动 。 要 关闭 树 蔡 派 的 用 户 界 面 〈 如 果 你 直接 或 从 计算 机 连接 到 该 用 户 界 面 )， 请 
通过 SSH 输入 以 下 内 容 : 
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$ sudo shutdown -h now 





注意 在 运行 上 一 个 命令 之 前 ， 需 要 确保 已 登录 到 你 的 树 莓 派 。 否 则 ， 你 可 能 会 
关闭 主 计算 机 (如 果 你 正在 运行 Linux )。 








输入 shutdown 命令 几 秒 钟 后 ， 树 莓 派 的 黄色 指示 灯 应 该 会 内 烁 10 次 。 现 在 你 
可 以 安全 地 拔 掉 插 头 。 





143 ”搭建 硬件 


除了 前 面 提 到 的 树 侮 派 和 外 设 之 外 ， 还 需要 以 下 各 项 和 连接 线 : 
e DHTII 传感器 ; 
e. 4.7kQ 电阻 ; 
e 1000 电阻 ; 
e 红色 LED; 


























图 14-5 展示 了 如 何 连接 所 有 器 件 。DHT11 的 VDD 引 脚 连接 到 + SV ( 树 莓 派 上 
的 引 脚 #2), DHT11 的 DATA 引 脚 连接 到 树 董 派 上 的 引 脚 #16, DHT11 的 GND 引 
脚 连接 到 树 莹 派 上 的 GND ( 引 脚 #6)。DATA 和 VDD 之 间 连 接 一 个 4.7kQ 电阻 。 


LED 的 阴极 (负极 ) 通过 1000. 电阻 器 连接 到 GND， 阳 极 CER) 连接 到 树 莓 派 的 
引 脚 #18。 






































pin #18 (board) 


> LED 
1 2 3 4 
(VDD) (DATA) (unused) (GND) 
1000 
+5V —— pin #6 (GND) 





pin #6 (GND) 


4.7 kQ pin 416 (board) 


14-5 49K. DHT11 电路 和 LED 之 间 的 连接 示意 
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可 以 用 无 焊接 的 面包 板 连接 DHT11 和 LED 电路 并 测试 该 装置 
当 它 的 工作 令 人 满意 后 ， 将 该 装置 移 到 定制 的 外 壳 中 。 





如 图 14-6 所 示 。 

















14-6 #4. DHT11 # LCD 与 面包 板 连接 


144 代码 














现在 ,我们 将 开发 在 树 医 派 上 运行 的 代码 (如 果 想 查看 完整 的 项 目 代 码 ， 请 跳 
到 14.5 43 . 
下 面 是 main) Až. 


def main(): 
print ‘starting piweather...' 
# create parser 
o parser = argparse.ArgumentParser(description-"PiWeather...") 
# add expected arguments 
parser.add_argument('--ip', dest='ipAddr', required=True) 
parser.add argument('--port', dest-'portNum', required=True) 


























# parse args 
args - parser.parse args() 


# GPIO setup 


e GPIO.setmode(GPIO.BOARD) 
e GPIO.setup(18, GPIO.OUT) 
o GPIO.output(18, False) 
# start server 
e run(host-args.ipAddr, port-args.portNum, debug-True) 
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在 @ 行 ， 设 置 了 

































































个 命令 行 参数 解析 器 ， 它 有 两 个 必需 参数 的 : 
器 局 动 的 IP 地 址 ，--port 表示 服务 器 端口 号 。 在 @ 行 ， 
使 用 BOARD 模式 ， 表 明 使 用 基于 板 的 物理 布局 的 引 脚 编号 惯例 。 





--ip 表示 服务 
局 动 GPIO 引 脚 设置 。 我 们 
在 自行 ， 将 引 肢 











#18 设置 为 输出 ， 因 为 我 们 打算 向 它 写 入 数据 来 控制 LED, 在 @ 行 , 设置 引 脚 值 为 


False, ATLA LED 在 启动 时 关闭 。 


然后 通过 提供 




















IP 地 址 和 端口 号 启动 Botte， 并 将 


debug 设置 为 True， 











监视 所 有 警告 消息 @。 

































































































































































14.4.1 处理 传感器 数据 请 求 
现在 快速 看 一 下 处 理 传感器 数据 请 求 的 函数 : 
© @route('/getdata', method='GET' ) 
9 def getdata(): 
e RH, T = Adafruit DHT.read retry(Adafruit DHT.DHT11, 23) 
# return dictionary 
o return {"RH": RH, "T": T} 
该 方法 定义 了 一 个 名 为 /getdata 的 路 由 @。 客 户 端 访问 此 路 由 定义 的 URL 
/getdata 时 ，getdata() 方 法 被 调用 @， 它 利用 Adafruit_DHT 模块 取得 湿度 和 温度 数 
据 @ ,在 @ 行 ,取得 的 数据 作为 字典 返回 , CHEJ JavaScript 对 象 表示 法 (JSON )” 
对 象 提供 给 客户 端 , ISON 对 象 包含 由 名 一 值 对 组 成 的 一 些 列表 , 可 以 作为 对 象 读 
入 。 在 这 个 例子 中 ，getdata0 返 回 的 JSON 对 象 有 个 两 名 一 值 对 : 一 个 是 湿度 读数 
CRH)， 一 个 是 温度 CT. 
14.4.2 ”绘制 数据 


部 分 ， 

















plotO 函 数 处 理 客户 端的 绘图 请 求 。 该 函数 的 多 
层 革 样式 表 (CSS)” 的 样式 ， 并 加 载 了 必要 的 JavaScript 代码 ， 



































设置 了 € 














如 下 所 示 : 


@route('/plot') 
def plot(): 


return ''' 


«html» 
«head» 
«meta http-equiv-"Content-Type" content-"text/html; charset-utf-8'» 


<title>PiWeather</title> 
<style> 
.demo-placeholder { 
width: 90%; 

height: 50%; 


} 
</style> 
<script language="javascript" 
src="jquery.js"></script> 
<script language="javascript" 
src="jquery.flot.js"></script> 
<script language="javascript" 
src="jquery.flot.time.js"></script> 
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第 一 部 分 定义 了 HTML 的 <head> 








type="text/javascript" 
type="text/javascript" 


type="text/javascript" 











plotO 函 数 是 /plot URL 的 Bottle 路 由 ， 这 表明 连接 到 该 URL 时 将 调用 plotQ 77 
法 。 在 @ 行 ，plot0 将 整个 HTML 数据 作为 单个 字符 串 返 回 ， 它 将 由 客户 端的 Web 
浏览 器 显示 。 列 表 中 的 初始 行 是 HTML 标题 ， 绘 图 的 CSS 大 小 声明 和 包含 flot Æ 
的 代码 ， 所 有 这 些 都 类 似 于 生成 图 14-4 中 的 flot 绘图 示例 的 设置 。 

代码 的 <body> 元 素 显 示 了 HTML 的 整体 结构 。 


<body> 
<div id="header"> 
o <h2>Temperature/Humidity</h2> 
</div> 





































































































<div id="content"> 
<div class="demo-container"> 


e «div id-"placeholder" class="demo-placeholder"></div> 
«[div» 
e «div id="ajax-panel"> </div> 
</div> 
<div> 
o <input type="checkbox" id-"ckLED" value="on">Enable Lighting. 
e «span id="data-values"> </span> 
</div> 
</body> 
</html> 











在 @ 行 ， 只 是 为 绘图 添加 了 一 个 标题 。 在 @ 行 添加 了 <placeholder> 元 素 ， 稍 后 
将 由 flot 的 JavaScript 代码 填充 。 在 自行 ， 定义 了 一 个 用 为 aax-panel 的 HTML 元 
R 它 将 显示 所 有 AJAX 错误 , 在 @ 行 , 创建 了 一 个 卫 为 ckLED 的 checkbox 元 素 ， 
它 控制 连接 到 树 蓉 派 的 LED。 最 后 , 创建 了 另 一 个 ID 为 data-values 的 HTML 元 素 
@， 当 用 户 单 击 绘 图 中 的 数据 点 时 ， 可 以 显示 传感器 数据 。JavaScript 代码 将 利用 这 
EE TD 来 访问 和 修改 相应 的 元 素 。 

现在 让 我 们 来 深入 了 解散 入 的 JavaScript 代码 ， 它 们 发 起 传感器 数据 请 求 ， 打 
开 和 关闭 LED。 这 上 段 代 码 在 <script language =“javascript”...> 标 记 中 ， 在 HTML 数 
Ji «head» 下面 。 


© $(document).ready(function() { 
































c— 




































































// plot options 
e var options - ( 
series: ( 
lines: (show: true}, 
points: (show: true} 


$a 
e grid: {clickable: true}, 
o yaxes: [{min: O, max: 100}], 


xaxes: [{min: 0, max: 100}], 


}; 


// create empty plot 
© var plot = $.plot("#placeholder", [[]], options); 


第 14 章 ”基于 树 莓 派 的 天 气 监 控 器 265 


HTML 数据 完全 加 载 后 ， 浏 览 器 调用 @ 行 的 ready0 函 数 。 在 @@ 行 ， 声 明了 一 个 
options 对 象 来 定制 绘图 。 在 此 对 象 中 ， 可 以 让 绘图 显示 线 和 点 ， 在 目 行 ， 人 允许 单 击 绘 
图 网 格 〈 用 于 查询 值 )。 在 @ 行 ， 设 置 了 坐标 轴 限 制 。 在 @ 行 ， 用 3 个 参数 调用 plotO 
创建 实际 绘图 : 要 在 其 中 显示 绘图 的 元 素 的 ID、 值 的 数组 〈 它 开始 为 空 )， 以 及 刚 
刚 设置 的 options 对 象 。 

接 下 来 ， 看 看 获取 传感器 数据 的 JavaScript 代码 。 

// initialize data arrays 
o var RH = []; 

var T = [I]; 


var timeStamp - []; 
// get data from server 





















































































































































e function getData() { 
// AJAX callback 

e function onDataReceived(jsonData) ( 
o timeStamp.push(Date()); 

// add RH data 
e RH.push(jsonData.RH); 

// removed oldest 
© if (RH.length > 100) { 


RH.splice(0, 1); 
} 
// add T data 
T.push(jsonData.T) ; 
// removed oldest 
if (T.length > 100) { 
T.splice(0, 1); 


for (var i = 0; i < RH.length; i++) { 
s1.push([i, RH[i]]); 
s2.push([i, T[i]]); 

} 

// set to plot 

e plot.setData([s1, s2]); 
plot.draw(); 
} 


// AJAX error handler 
© function onError(){ 
$('#ajax-panel').html('<p><strong>Ajax error!</strong> </p>'); 


} 


// make the AJAX call 
© $.ajax({ 
url: "getdata", 
type: "GET", 
dataType: "json", 
success: onDataReceived, 
error: onError 


ni 
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在 @ 行 ， 初 始 化 温度 和 湿度 值 的 空 数 组 ， 以 及 一 个 timeStamp 数组 ， 保 存 收集 
每 个 值 的 时 间 。 在 @ 行 定义 了 getData0 方 法 ， 我 们 利用 定时 器 定期 调用 该 方法 。 
自行 ,定义 了 onDataReceived0) 方 法 , 它 被 设置 为 AJAX 调用 的 ASH HE. JavaScript 
中 ， 可 以 在 函数 中 定义 函数 ， 这 些 函 数 可 以 像 常 规 变 量 一 样 使 用 ， 所 以 可 以 在 
getData0 函 数 中 定义 onDataReceived0， 然 后 将 它 作为 回调 函数 传递 给 AJAX 调用 。 

onDataReceived() KOJ Æ J JavaScript Date WR, (RAFAH ASIN TAO. 来 
自 服务 器 的 数据 利用 jsonData 对 象 传 入 OnDataReceived0， 在 @@ 行 ， 将 来 自 此 对 象 
的 温度 数据 记 入 数组 。 在 @ 行 ， 如 果 元 素数 量 超过 100， 就 删除 数组 中 最 早 的 元 素 ， 
这 将 产生 滚动 图 , 类 似 第 12 BPH Arduino 光 传 感 器 项 目 创建 的 滚动 图 。 我们 用 相 
同 的 方式 处 理 湿度 数据 。 
在 @ 行 ， 收 集 的 数据 被 格式 化 ， 以 便 适 合 传递 给 plot0 方 法 。 由 于 要 同时 绘制 
两 个 变量 ， 所 以 需要 一 个 包含 3 个 图 层 的 数组 : 

[Lio RHo0], Li, RH], ...], [lio, Tol, La, Ti] 

在 @ 行 ， 数 据 被 设置 并 绘制 。 

在 @ 行 ， 定 义 了 一 个 错误 回调 ，AJAX 将 使 用 之 前 设置 的 、ID 为 ajax-panel 的 
HTML 元 素来 显示 错误 。 在 四 行 ， 进 行 实际 的 AJAX 调用 ， 它 指定 URL 为 getdata， 
BJ Bottle 路 由 。 该 调用 利用 HTTP 的 GETO 方 法 ， 以 json 格式 从 服务 器 请 求 数据 。 
AJAX 设置 调 14% OnDataReceived(0) 方 法 设置 为 成 功 回 调 ， 并 将 onError0 设 置 为 错 
误 回 调 。 这 个 AJAX 调用 会 立即 返回 ， 并 在 数据 可 用 时 ， 异 步 激活 回调 方法 。 








H t x 







































































































































































































































































































































































14.4.3 update() 方 法 
现在 看 看 每 秒 调用 getData0 的 updated) Wik. 









































// define an update function 
function update() { 


// get data 
o getData(); 
// set timeout 
e setTimeout(update, 1000); 


} 


// call update 
update(); 


update0 方 法 首先 在 @ 行 调用 getData0, 在 @ 行 利用 JavaScript HY setTimeout() 
方法 在 1000 毫秒 后 调用 它 自己 。 因 此 ，getData0 每 秒 都 会 被 调用 ， 从 服务 器 请 求 传 
感 器 数据 。 
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14.4.4 用 于 LED 的 JavaScript 处 理 程序 
现在 来 看 看 LED 复 选 框 的 JavaScript 处 理 程序 , 它 向 Web 服 务 器 发 送 一 个 AJAX 
请 求 。 
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// define the click handler for the LED control button 
$('#ckLED').click(function() { 
var isChecked = $("#ckLED").is(":checked") ? 1:0; 
$.ajax({ 
url: '/ledctrl', 
type: 'POST', 
data: ( strID:'ckLED', strState:isChecked } 
2r 
}); 


在 @ 行 , 为 前 面 在 HTML 中 创建 的 ID 为 ckLED 的 复 选 框 定义 了 一 个 点 击 处 到 
程序 。 每 次 用 户 单 击 复 选 框 时 ， 将 调用 这 个 单 击 处 理 程 序 函 数 。 该 函数 保存 复 选 机 
的 状态 @, 然后 自行 的 代码 利用 URL /ledctrl 和 HTTP 请 求 类 型 POST 来 调用 AJAX, 
已 将 选中 的 状态 作为 数据 发 送 。 
这 个 AJAX 请 求 的 服务 器 端 处 理 程序 根据 请 求 将 树 侮 派 的 GPIO 引 脚 设置 为 打 
开 或 关闭 。 
© @route('/ledctrl', method='POST') 
def ledctrl(): 

val = request.forms.get('strState') 

on = bool(int(val)) 

GPIO.output(18, on) 

在 @ 行 ， 定 义 了 URL /ledctrl 的 Bottle 路 由 ， 这 是 处 理 此 请 求 的 ledctrl0 方 法 的 
装饰 器 。 在 @ 行 ， 利 用 Bottle 的 request 对 象 访问 由 客户 端 代码 发 送 的 strState 参数 
的 字符 串 值 ， 该 值 在 目 行 转换 为 布尔 值 。 对 引 脚 #18 使 用 GPIO.output(0 方 法 ， 打 开 
或 关闭 连接 到 此 引 脚 的 LED@。 
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14.4.5 ”添加 交互 性 
我 们 还 希望 为 绘图 提供 一 些 交 互 性 。 flot 库 提 供 了 一 种 方式 让 用 户 点 击 数据 点 
获取 值 ， 这 是 在 调用 plotO 函 数 时 ， 通 过 在 options 中 传 入 clickable:true 而 启用 的 。 
下 面 ， 我 们 定义 在 单 击 数据 点 时 要 调用 的 函数 : 


$("#placeholder").bind("plotclick", function (event, pos, item) { 








































































































if (item) { 
o plot.highlight(item.series, item.datapoint); 
e var strData = ' [Clicked Data: ' + 
timeStamp[item.dataIndex] + ': T= ' + 
T[item.dataIndex] + ', RH = ' + RH[item.dataIndex] 
dep 
e $('4data-values').html(strData); 
} 
3 
3 
«[script» 
«[head» 
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该 函数 在 @ 行 调用 flot 的 highlight0 方 法 ,在 单 击 的 点 周围 绘制 一 个 圆 环 。 在 @ 
行 ， 它 准备 一 个 字符 串 ， 以 显示 在 ID 为 data-value 的 HTML 元 素 中 。 点 击 数据 点 
IN, flot 会 向 函数 传 入 一 个 item 对 象 ， 它 有 一 个 名 为 datalndex 的 成 员 。 我 们 可 以 利 
此 索引 ,从 ready0 函 数 中 定义 的 时 间 截 、 温度 和 湿度 数组 中 取得 相关 数据 。 最 后 ， 
将 字符 串 添加 到 HTML LRO. 

这 就 是 Python (RAS HAHAH JavaScript， 但 我 们 还 需要 一 个 Bottle 路 由 来 找到 
Web 页 面 需要 的 JavaScript 文件 ， 如 下 所 示 : 


@route('/<filename:re:.*\.js>') 
def javascripts(filename) : 
return static_file(filename, root='flot') 


这 上段 代码 告诉 Bottle 服务 器 在 子 目 录 float/ 下 查找 这 些 文件 , 它 在 与 程序 同 级 的 
目录 下 。 





















































































































































14.5 “完整 代码 


可 以 在 https://github.com/electronut/pp/tree/master/piweather/piweather.py 找到 此 
项 目的 完整 代码 列表 。 


from bottle import route, run, request, response 
from bottle import static_file 

import random, argparse 

import RPi.GPIO as GPIO 

from time import sleep 

import Adafruit_DHT 








eroute('/hello') 
def hello(): 
return "Hello Bottle World!" 


@route('/<filename:re:.*\.js>') 
def javascripts(filename) : 
return static_file(filename, root='flot') 


@route('/plot') 
def plot(): 
return ''' 
«html» 
«head» 
«meta http-equiv="Content-Type" content-"text/html; charset=utf-8"> 
<title>PiWeather</title> 
<style> 
.demo-placeholder { 
width: 90%; 
height: 50%; 
j 
</style> 
<script language="javascript" type="text/javascript" 
src="jquery.js"></script> 
<script language="javascript" type="text/javascript" 
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src="jquery.flot.js"></script> 

<script language="javascript" type="text/javascript" 
src="jquery.flot.time.js"></script> 

<script language="javascript" type="text/javascript"> 


$(document).ready(function() { 


// plot options 
var options = { 
series: { 
lines: {show: true}, 
points: {show: true} 
h 
grid: {clickable: true}, 
yaxes: [{min: 0, max: 100}], 
xaxes: [{min: 0, max: 100}], 


}; 


// create empty plot 
var plot = $.plot("#placeholder", [[]], options); 


// initialize data arrays 
var RH = []; 
var T= []; 
var timeStamp = []; 
// get data from server 
function getData() { 
// AJAX callback 
function onDataReceived(jsonData) { 
timeStamp.push(Date()); 
// add RH data 
RH.push(jsonData.RH); 
// removed oldest 
if (RH.length » 100) ( 
RH.splice(0, 1); 


} 

// add T data 

T.push(jsonData.T); 

// removed oldest 

if (T.length » 100) ( 
T.splice(0, 1); 


} 
si = []; 
s2 = []; 


for (var i = 0; i < RH.length; i++) { 
s1.push([i, RH[i]]); 
s2.push([i, T[i]]); 

} 

// set to plot 

plot.setData([s1, s2]); 

plot.draw(); 

} 


// AJAX error handler 
function onError(){ 
$('#ajax-panel').html('<p><strong>Ajax error!«/strong» </p>'); 


} 
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} 


// make the AJAX call 


$.ajax({ 
url: "getdata", 
type: "GET", 


dataType: "json", 
success: onDataReceived, 
error: onError 


ni 


// define an update function 
function update() { 


} 


// get data 

getData(); 

// set timeout 
setTimeout(update, 1000); 


// call update 
update(); 


// define click handler for LED control button 
$('#ckLED').click(function() { 


var isChecked = $("#ckLED").is(":checked") ? 1:0; 


$.ajax({ 
url: '/ledctrl', 
type: 'POST', 
data: { strID:'ckLED', strState:isChecked } 
3 
3 
$("4placeholder").bind("plotclick", function (event, pos, item) ( 
if (item) { 
plot.highlight(item.series, item.datapoint); 
var strData = ' [Clicked Data: ' + 
timeStamp[item.dataIndex] + ': T= ' + 
T[item.dataIndex] + ', RH = ' + RH[item.dataIndex] 
*c]' 
$('£data-values').html(strData); 
} 
}); 
}); 
</script> 
</head> 
<body> 


«div id-"header'» 
«h2»Temperature/Humidity«/h2» 
«[div» 


«div id-"content'» 
«div class-"demo-container"» 
«div id-"placeholder" class-"demo-placeholder"»«/div» 
«[div» 
«div id="ajax-panel"> </div> 
</div> 
<div> 
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<input type="checkbox" id-"ckLED" value="on">Enable Lighting. 
<span id="data-values"> </span> 
</div> 


</body> 
</html> 


@route('/getdata', method='GET' ) 

def getdata(): 
RH, T = Adafruit_DHT.read_retry(Adafruit_DHT.DHT11, 23) 
# return dictionary 
return {"RH": RH, "T": T} 


@route('/ledctr1', method='POST' ) 
def ledctrl(): 
val = request.forms.get('strState') 
on = bool(int(val)) 
GPIO.output(18, on) 


# main() function 

def main(): 
print 'starting piweather...' 
# create parser 
parser = argparse.ArgumentParser(description-"PiWeather...") 
# add expected arguments 
parser.add argument('--ip', dest-'ipAddr', required=True) 
parser.add argument('--port', dest-'portNum', required-True) 


# parse args 
args = parser.parse_args() 


# GPIO setup 

GPIO.setmode(GPIO.BOARD) 

GPIO.setup(18, GPIO.OUT) 

GPIO.output(18, False) 

# start server 

run(host=args.ipAddr, port=args.portNum, debug=True) 


# call main 
if name == main 
main() 





14.6 “运行 程序 
将 树 侮 派 连接 到 DHTI1L 和 LCD 电路 后 , 利用 SSH 从 计算 机 登录 树 侮 派 ， 并 输 
入 以 下 内 容 〈 蔡 换 你 为 树 侮 派 设置 的 耳 地 址 和 端口 ): 


$ sudo python piweather.py --ip 192.168.x.x --port xxx 
MEFA HAE ZED aS HEE Hei AT ERA IP 地 址 和 端口 ， 形 式 为 : 
http: //192.168.x.x:port/plot 


你 应 该 看 到 如 图 14-7 所 示 的 图 形 。 
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Temperature/Humidity 





00000000909000009009000900900000000000000900009/090999000000000009909000 90900000900000000900000 








Enable Lighting. {Clicked Data: Tue Jun 24 2014 15:55:30 omr+0s30 (IST): T = 28, RH = 45) 
14-7 piweather.py 示例 运行 的 结果 网 页 和 图 表 


如 果 点 击 图 表 中 的 任何 数据 点 ， 点 击 的 数据 部 分 应 该 更 新 ， 显 示 有 关 该 点 的 更 
多 信息 。 在 收集 到 100 个 点 后 , 当 新 数据 进入 时 , 图 形 将 开始 水 平 滚动 ( 单 击 Enable 
Lighting 复 选 框 来 打开 和 关闭 LED). 









































14.7. “小结 


























本 项 目 构建 了 一 个 基于 树 侮 派 的 天 气 监 视 器 , 通过 Web 界面 绘制 温度 和 湿度 数 
据 。 下 面 是 本 项 目 涵盖 的 一 些 概念 : 
。 设置 树 莓 派 ; 
。 使 用 树 莓 派 的 GPIO 引 脚 与 硬件 通信 ; 
。 与 DHT11 温 湿度 传感器 接口 ; 
e 使 用 Python Web 框架 Bottle 来 创建 Web 服务 器 ; 
。 使 用 JavaScript 库 flot 来 制作 图 表 ; 
。 构建 客户 端 一 服务 器 应 用 程序 ; 
。 通过 Web 界面 控制 硬件 。 




































































14.8 ”实验 


请 尝试 通过 以 下 修改 来 改进 此 项 目 。 

1. 提供 一 种 导出 传感器 数据 的 方法 。 一 种 简单 的 方法 是 在 服务 器 上 维护 一 
个 CT, RED 元 组 的 列表 ， 然 后 为 /export 写 一 个 Bottle 路 由 ， 并 在 这 个 方法 中 返 
回 CSV 格式 的 值 。 修 改 /plot 路 由 , 使 其 包含 HTML 代码 , 在 网 页 上 放置 “Export” 
按钮 。 单 击 该 按钮 时 ， 有 相应 的 AJAX 代码 调用 服务 器 上 的 export0 方 法 ， 它 将 
发 送 要 在 浏览 器 中 显示 的 CSV 值 。 然 后 ， 这 些 值 可 以 让 用 户 从 浏览 器 窗口 中 复 
制 或 保存 。 
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.该 程序 绘制 DATI 数据 ， 但 100 个 值 后 ， 它 开始 滚动 。 如 果 想 查看 更 长 时 
办 ? 一 种 方法 是 在 服务 器 上 维护 一 个 较 长 的 (T, RH) 元 组 列表 ， 
然后 修改 服务 器 代码 ， 利 用 一 个 按钮 来 发 送 HTML 数据 ， 并 使 用 必要 的 JavaScript 
代码 ， 在 绘制 完整 范围 的 数据 或 仅 绘制 最 近 100 个 值 之 间 切 换 。 如 何 取得 树 侮 派 关 
闭 之 前 的 老 数 据 〈 提 示 : 当 服 务 器 退出 时 ， 将 数据 写 入 文本 文件 ， 并 在 启动 时 加 载 
老 数 据 ) ? 要 使 此 项 目 真正 可 扩展 ， 请 使 用 数据 库 ， 如 SQLite. 
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FEAT SCH, BOATS 
的 外 部 模块 和 代码 。 由 于 第 





关 项 目 











A. 安 效 本 书 项 目的 源 代码 
你 可 以 从 https:Wgithub.comyelectronutpp/ 下 载 这 本 书 的 项 目的 源 代 码 。 使 月 








附录 A 
EXE 












































的 安装 ， 这 里 将 跳 过 这 些 说 明 。 本 书 中 的 项 目 已 经 用 
Python 2.7.8 和 Python 3.3.3 进行 了 测试 。 








站 上 的 Download ZIP 选项 来 获取 代码 。 





下 载 并 解压 缩 代 码 后 ， 


pp-master/common) 添加 到 PYTHONPATH 环境 变量 ， 


这 些 Python 文件 。 

















需要 将 下 载 的 代码 


如 何 安装 Ta 以 及 本 书 中 使 用 


14 章 中 已 经 介绍 了 几 个 树 侮 派 相 





















































日 此 网 




















的 common 文件 夹 的 路 径 〈 通 常 为 


























， 以 便 





模块 可 以 查找 条 




















I 使 用 














在 Windows E, 实现 的 方式 是 创建 PYTHONPATH 环境 变量 , 如 果 它 已 经 存在 ， 
Wyse. FEOSK 上 ， 可 以 将 此 行 添 加 到 主 目录 中 的 .profile 文件 〈 如 果 需 要 就 创 
建 一 个 文件 ): 





























export PYTHONPATH=$PYTHONPATH:path_to_common_folder 























Linux 用 户 可 以 执行 类 似 于 OS X 的 操作 , 在 .bashrc、.bash_profile 或 .cshrc/.login 
中 添加 。 可 以 使 用 echo $SHELL 命令 查看 默认 shell。 


现在 ， 来 看 看 如 何在 Windows, OS X 和 Linux 上 安装 Python 以 及 本 书 中 使 用 
的 模块 。 
















































































A.2 在 Windows 上 安装 
首先 ， 从 https:Wwww.python.org/download/ 下 载 并 安装 Python. 


A.2.1 安装 GLFW 


对 于 本 书 中 基于 OpenGL 的 3D 图 形 项 目 , 需要 GLFW FE, 你 可 以 从 http:/www.glfw. 
org/download.html 下 载 。 

在 Windows 上 ， 安 装 GLFW 后 , 将 GLFW. LIBRARY 环境 变量 (在 搜索 栏 中 键 
A Edit Environment Variables ) 设 置 为 安装 glfw3.dl 的 完整 路 径 , 以 便 GLFW 的 Python 
绑 定 能 找到 此 库 。 路 径 看 起 来 类 似 Ci\ glfw-3.0.4.bin. WIN32\lib-msve120\glfw3.dll. 

在 Python 中 使 用 GLFW， 要 用 一 个 名 为 pyglfw 的 模块 ， 它 由 一 个 Python 文件 
组 成 ， 名 为 glfw.py。 你 不 需要 安装 pyglfw， 因 为 本 书 的 源 代码 已 包含 它 ， 可 以 在 
common 目录 中 找到 它 。 但 是 , 如果 需要 安装 较 新 的 版 本 , 来 源 是 https://github.com/ 
rougier/pyglfw/. 

你 还 需要 确保 计算 机 已 安装 显卡 驱动 程序 。 这 通常 是 有 好 处 的 ， 因 为 许多 软件 
程序 (特别 是 游戏 ) 都 会 利用 图 形 处 理 单元 (GPUD. 


A.2.2 为 每 个 模块 安装 预先 构建 二 进 制 文件 


在 Windows 上 安装 必要 的 Python 模块 ， 最 简单 的 方法 是 获取 预先 构建 的 二 进 
制 文件 。 每 个 模块 的 链接 在 下 面 列 出 。 请 下 载 适 当 的 安装 程序 (32 或 64 位 。 根 据 
Windows 设置 ， 你 可 能 需要 以 管理 员 权 限 来 运行 这 些 安装 程序 。 


pyaudio 























































































































































































































http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyaudio 
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pyserial 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyserial 
scipy 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#scipy 
http://sourceforge.net/projects/scipy/files/scipy/ 
numpy 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#numpy 
http://sourceforge.net/projects/numpy/files/NumPy/ 
pygame 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pygame 
Pillow 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pillow 
https://pypi.python.org/pypi/Pillow/2.5.0#downloads 
pyopengl 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyopengl 
matplotlib 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#matplotlib 


matplotlib 库 依 赖 于 dateutil, pytz. pyparsing 和 six， 这 些 依赖 库 可 以 从 以 下 链 
接 获得 ; 
dateutil 








http://www.lfd.uci.edu/~gohlke/pythonlibs/#python-dateutil 
pytz 

http://www.lfd.uci.edu/~gohlke/pythonlibs/#pytz 
pyparsing 
http://www.lfd.uci.edu/~gohlke/pythonlibs/#pyparsing 

SIX 


http://www.lfd.uci.edu/-gohlke/pythonlibs/Zsix 
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A.2.3 ”其 他 选项 
你 也 可 以 安装 适当 的 编译 器 ， 在 Windows 上 自己 构建 所 有 必需 的 软件 包 。 有 关 兼 
容 编译 器 的 列表 ， 参 见 https://docs.python.org/2/install/index.html#gnu-c-cygwin-mingw。 
另 一 个 选择 是 在 http:/www.scipy.org/install.html 安装 特殊 的 Python 发 行 版 ， 其 中 预 装 
了 大 部 分 这 些 软件 包 。 





















































A.3 fEOSX ER 


以 下 是 在 OS X 上 安装 Python 和 必要 模块 的 建议 步骤 。 











A.3.1 安装 Xcode 和 MacPorts 
第 一 步 是 安装 Xcode。 你 可 以 通过 App Store 获取 它 。 如 果 你 运行 的 是 旧版 本 
的 操作 系统 ， 则 可 以 从 Apple 开发 人 员 网 站 Chttps: // developer.apple.com/) 获取 兼 
容 版 本 的 Xcode. Z Xcode 后 ， 请 确保 也 安装 了 命令 行 工 具 。 下 一 步 是 安装 
MacPorts。 你 可 以 参考 MacPorts 指南 (http://guide.macports.org/#installing.xcode )， 
其 中 包含 了 详细 的 安装 说 明 ， 以 帮助 你 完成 此 过 程 。 
MacPorts 安装 自己 的 Python 版 本 ， 最 简单 的 方法 是 你 的 项 目 就 使 用 该 版 本 
COS X 也 内 置 了 Python， 但 在 它 上 面 安 装 模 块 有 许多 问题 ， 所 以 最 好 不 要 管 它 )。 
































































































































A.3.2 ”安装 模块 
安装 MacPorts 后 ， 可 以 使 用 Terminal (终端 ) 应 用 程序 中 的 port 命令 ， 安 装 本 
书 所 需 的 模块 。 
在 终端 窗口 中 使 用 下 面 的 命令 检查 Python 的 版 本 : 






























































E 














$ port select --list python 











如 果 你 有 多 个 Python 安装 ， 可 以 使 用 下 面 的 命令 ， 选 择 特 定 版 本 的 Python 作 
73 MacPorts 的 活动 版 本 〈 这 里 选择 了 Python 版 本 2.7): 









































$ port select --set python python27 





然后 可 以 安装 所 需 的 模块 。 在 终端 窗口 中 逐个 运行 这 些 命令 。 








sudo port install py27-numpy 
sudo port install py27-Pillow 
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sudo port install py27-matplotlib 
sudo port install py27-opengl 
sudo port install glfw 

sudo port install py27-scipy 

sudo port install py27-pyaudio 
sudo port install py27-serial 
sudo port install py27-game 


























MacPorts 通常 将 Python 安装 在 /opt/local/ 中 。 可 以 通过 在 .profile 中 设置 PATH 
环境 变量 ， 来 确保 在 终端 窗口 中 获得 正确 的 Python 版 本 。 这 是 我 的 设置 : 












































PATH=/opt/local/Library/Frameworks/Python.framework/Versions/2.7/bin:$PATH 
export PATH 





T 























这 段 代 码 确保 正确 的 Python 版 本 可 以 从 任何 终端 运行 。 


A.A 在 Linux 上 安装 


Linux 通常 内 置 Python 并 且 构 建 所 需 软 件 包 的 所 有 开发 工具 。 在 大 多 数 Linux 
发 行 版 上 ， 应 该 能 够 使 用 pip 获取 本 书 所 需 的 包 。 有 关 安 装 pip 的 说 明 ， 请 参阅 以 
下 链接 : http://pip.readthedocs.org/en/latest/installing.html。 


可 以 用 pip 安装 一 个 包 ， 像 这 样 : 
















































































sudo pip install matplotlib 

















另 一 种 安装 软件 包 的 方法 是 下 载 模块 源 代 码 ， 通 常 是 .gz 或 .zip 文件 。 将 这 些 文 
件 解 压缩 到 文件 夹 后 ， 可 以 按 如 下 方法 安装 它们 : 


sudo python setup.py install 





























对 于 本 书 所 需 的 每 个 包 ， 你 需要 使 用 这 些 方法 中 的 一 种 。 
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rl, UOT ak INA, H 


B.l 向 用 组 件 


大 多 数 电 子 部 件 使 用 


电子 器 从 


附录 B 


基础 实用 电子 学 


件 ， 设 


始 玩 电 
是 一 个 


















































计 和 构造 电路 。 


这 个 主题 很 大 , 所 以 我 仅仅 
(自己 动手 ) 的 角度 来 看 ， 你 不 
































本 附录 简要 介绍 了 搭建 电子 电路 相关 的 一 些 基 本 术语 、 组 
件 和 工具 。 电 子 学 是 工程 学 分 文 ， 涉 及 利用 有 源 和 无 源 电子 元 






































企及 皮毛 “。 但 从 爱好 者 或 DIY 

















而 














子 电路 。 你 可 以 在 搭建 






























































构造 的 理想 选择 。 





























要 知道 一 大 堆 知识 ， 就 能 开 
学 习 ， 根 据 我 自己 的 经 验 ， 这 
有 趣 的 、 令 人 上 疗 的 爱好 。 我 希望 通过 快速 介绍 以 下 主 
F 让 你 开始 设计 和 搭建 自己 的 电路 。 


































































































半导体 类 的 材料 。 半 导体 具有 特殊 的 电气 特性 ， 使 其 成 为 








GD 关于 电子 学 的 全 面 参考 ， 我 推荐 Paul Scherz 和 Simon Monk 的 《Practical Electronics for Inventors》 第 3 版 (McGraw-Hill, 





2013)。 





件 ， 














在 本 节 中 ， 我 们 将 介绍 电路 中 使 用 的 一 些 
以 及 在 电路 图 中 表示 它们 的 


Ate TA 


TUS. 


tg 最 常见 的 组 件 。 图 B-1 展示 了 这 些 组 
BREAD SOA RD 
PCB 





CAPACITOR 
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E BATTERY / 
Powe f 
一 | 一 
ELECTRO mic 
图 B-1 常用 电子 组 件 及 其 相应 的 符号 
B.1.1 面包 板 
面包 板 是 用 于 原型 电子 电路 的 多 孔 模 块 。 面 包 板 的 孔 中 有 带 弹 赞 的 夹子 ， 并 且 
以 简单 的 方式 互 连 ， 容 易 进 行 实验 。 不 必 焊 接 每 个 连接 ， 只 要 将 组 件 插入 面包 板 ， 
并 用 电线 连接 它们 
B.1.2 ”光敏 电阻 ( LDR ) 
LDR 是 一 种 电阻 器 ， 其 电阻 随 着 照 在 其 上 的 光 的 强度 而 减 小 。 它 用 作 电 子 电路 
中 的 光 传 感 器 
B.1.3 ”集成 电路 (IC) 
IC 是 包含 完整 电子 电路 的 器 件 。IC 非常 小 ， 
管 。 每 个 IC 通常 都 有 一 种 特定 的 应 用 
气 和 物理 特性 ， 以 及 示例 应 用 程序 ， 
蕊 的 主要 用 作 定 时 器 
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能 会 遇 





每 平方 厘米 可 以 包含 数 十 亿 晶体 
1 造 商 的 数据 表 提 供 了 必要 的 原 到 
以 帮助 用 户 。 你 可 








IAIN 里 图 、 FH, 
到 的 常见 IC 是 555 














B.1.10 


印刷 电路 板 ( PCB ) 
要 制作 电子 电路 ， 需 要 一 个 地 方 来 组 装 组 件 。 
PCB 由 绝缘 体 组 成 ， 绝 缘 体 上 有 
方式 让 它 形成 电路 的 布线 。 
元 件 作 为 “ 通 孔 ”元 件 或 “表面 安装 ”元 件 安装 到 PCB 上 ， 
实现 导电 连接 。 























通常 在 PCB 上 完成 此 操作 ， 该 
层 或 多 层 导 电 材料 通常 为 铜 )。 导 电 层 成 形 的 



















































































通过 焊接 与 导电 层 











电线 














搭 电 路 不 能 





没有 电线 。 我 们 将 使 用 塑料 绝缘 的 铜 线 。 








电阻 






























































电阻 是 电路 中 最 常见 的 元 件 之 一 。 电 阻 用 于 减 小 电路 中 的 电流 或 电压 ， 并 且 根 据 
其 阻 值 〈 以 欧姆 为 单位 ) 来 指定 。 例如 ， 2.7k 欧姆 电阻 具有 2.7 千 欧 姆 或 2700 欧姆 的 


阻 值 。 电 阻 具有 指示 其 阻 值 的 彩色 编码 带 ， 以 及 两 个 可 互 换 的 引线 ， 因 为 它 没有 极 性 。 

























































































发 光 二 极 管 ( LED ) 


LED 是 在 许多 电路 中 看 到 的 小 闪烁 的 灯 。 然 而 ，LED 是 特殊 类 型 的 二 极 管 ， 
此 它 也 具有 极 性 ， 并 需要 根据 极 性 连接 。 它 通常 与 电阻 器 结合 使 用 ， 限 制 流 过 它 的 
电流 ， 因 此 不 会 损坏 。 不 同 颜色 的 LED 具有 不 同 的 最 小 “ 导 通 ”电压 。 
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它 是 根据 电容 量 来 测量 的 ， 其 单位 
型 电容 的 电容 量 以 微 法 (nF)》 为 单位 。 电 容 有 极 化 和 非 极 化 两 种 。 




















电容 是 有 两 个 引线 的 器 件 ， 用 于 存储 电荷 。 
为 法 拉 。 典 




































































二 极 管 是 允许 电流 仅 在 一 个 方向 上 通过 的 电子 器 件 。 二 极 管 通常 用 作 整 流 器 
(将 AC 电流 转换 为 DC 的 器 件 )。 二 极 管 有 两 根 引 线 : 阳极 和 阴极 。 这 意味 着 它 有 
极 性 ， 所 以 两 根 引 线 需 要 与 电路 的 其 余部 分 正确 连接 。 









































晶体 管 



































体 管 可 以 看 成 是 电子 





开关 。 





晶体 管 还 可 以 用 作 电 流 或 电压 的 放大 器 。 作 为 集 
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成 电路 的 基本 构件 ， 它 是 最 重要 的 电子 部 件 之 一 。 晶 体 管 有 几 种 类 型 ， 但 最 常见 的 
是 双 极 型 晶体 管 BIT) 和 金属 氧化 物 半 导体 场 效 应 晶体管 (MOSFET)。 唱 体 管 通 
常 有 三 根 引线 。 对 于 BIT, 它们 被 命名 为 基 极 、 集 电极 和 发 射 极 ， 而 对 于 MOSFET, 
它们 被 命名 为 栅 极 、 源 极 和 漏 极 。 当 晶体 管用 作 开 关 时 ,BJT 的 基 极 电流 (或 MOSFET 
的 栅 极 电压 )， 是 让 电流 能 够 流 过 集 电 极 和 发 射 极 的 原因 ， 因 此 它 作 为 开关 ， 控 制 
外 部 负载 ， 如 LED 或 继电器 。 






























































B.1.11 电池 /电源 


大 多 数 电子 设备 在 3 到 9 伏 的 小 电压 下 工作 ， 这 种 电压 可 以 由 电池 提供 ， 或 利 
用 插入 墙 上 交流 电源 插座 的 电源 适配器 提供 。 









































B 基本 工具 


除了 刚才 描述 的 组 件 ， 你 还 需要 一 些 基 本 工具 ， 才 能 开始 搭建 电子 电路 。 图 B-2 
展示 了 业余 爱好 者 的 工作 台 上 通常 会 看 到 的 工具 。 接 下 来 介绍 其 中 一 些 基本 工具 。 





















































图 B-2 典型 的 电子 工作 台 ， 有 万 用 表 、 工 作 灯 、 夹 具 、 剥 线 钳 、 螺 丝 刀 、 
尖 嘴 钳 、 放 大 镜 、 焊 锡 、 焊 剂 、 示 波 器 和 焊接 台 


B.2.1 万 用 表 


万 用 表 是 用 于 测量 电路 的 电气 特性 例如 电压 、 电 流 、 电 容 和 电阻 》 的 仪器 。 
它 还 经 常用 于 测量 电路 中 的 连续 性 , 这 表示 电流 的 连续 流动 。 当 你 试图 调试 电路 时 ， 
万 用 表 是 非常 有 用 的 。 
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B.2.2 烙铁 及 配件 


对 电路 在 面包 板 上 工作 感到 满意 后 , 下 一 步 就 是 将 它 转移 到 PCB 上, 这 需要 焊 
接 。 焊 接 是 使 用 加 热 的 填充 金属 来 接合 两 种 金属 的 过 程 。 填 料 或 焊料 ， 过 去 含 铅 ， 
但 现在 常用 无 铅 焊 料 合金 ， 这 更 环保 。 要 焊接 元 件 时 ， 将 元 件 放 在 PCB 上 ， 加 上 助 
焊剂 “使 焊接 过 程 更 容易 的 化 学 品 )， 然 后 将 热 的 焊料 与 烙铁 一 起 使 用 。 焊 料 冷却 
时 ， 它 在 部 件 和 铜 稍 层 之 间 形 成 物理 结合 和 电 连 接 。 



























































































































































B.2.8 示波器 


示波器 是 用 于 测量 和 显示 来 自 电子 电路 的 电压 的 仪器 。 它 是 分 析 电 压 波 形 的 有 
用 工具 。 例 如 ， 可 以 用 它 来 调试 从 传 感 器 输出 的 数字 数据 ， 或 测量 从 音频 放大 器 输 
出 的 模拟 电压 。 它 还 有 其 他 专门 的 测量 功能 ， 如 快速 传 里 叶 变 换 〈FFT) 和 均 方 
(RMS). 


图 B-2 还 展示 了 搭建 电路 的 一 些 其 他 有 用 的 工具 : ZRIRA RR KR 
钳 、 用 于 在 焊接 时 固定 PCB 的 夹具 、 让 工作 区 域 照 明 恨 好 的 台灯 、 帮 助 你 查看 小 元 
件 和 焊接 点 的 放大 镜 ， 以 及 用 于 烙铁 头 的 清洁 器 。 
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B.3 搭建 电路 


在 搭建 电路 时 ， 从 电路 图 或 原理 图 开始 , 它 将 告诉 你 组 件 如 何 相 互 连 接 。 通 常 ， 
你 会 在 面包 板 上 搭建 该 电路 ， 插 入 元 件 并 用 导线 连接 它们 。 测 试 电路 并 满意 后 ， 你 
可 能 会 考虑 把 它 移 到 PCB E. 虽然 面包 板 很 方便 , 但 它 看 起 来 有 点 乱糟糟 ,这些 松 
散 的 电线 在 部 署 时 会 不 可 靠 。 

你 可 以 使 用 通用 PCB, 它 的 底部 有 固定 的 铜 图 案 ， 也 可 以 设计 自己 的 PCB。 前 
者 很 适合 小 电路 。 通 常 ， 你 会 焊接 元 件 ， 利 用 已 经 存在 的 铜 和 连接 ， 然 后 根据 需要 
通过 焊接 额外 的 电线 来 搞定 其 余部 分 。 图 B-3 展示 了 一 个 简单 电路 的 原理 图 、 面 包 
板 原型 和 PCB 结构 。 

如 果 你 想 要 非常 漂亮 的 PCB， 可 以 自己 设计 一 个 并 制造 出 来 ， 也 花费 不 多 。 有 
几 个 软件 包 可 用 于 设计 PCB ， 但 最 常用 的 〈 免 费 ) 有 EAGLE“ 和 KiCad”。EAGLE 软 
件 有 一 个 简 版 是 免费 的 ， 条 件 是 只 用 于 非 营 利 应 用 。 它 有 一 定 的 限制 (例如 ， 只 有 
两 个 铜 层 ， 最 大 PCB 尺 寸 为 10 厘米 X8 厘米 ， 每 个 项 目 一 张 原理 图 )， 但 这 些 对 于 

































































































































































































































































































































































































































































(D) CadSoft EAGLE PCB 设计 软件 ，http://www.cadsoftusa.com/eagle-pcb-design-software/。 
© KiCad EDA 软件 套件 ，http://www.kicad-pcb.org/display/KICAD/KiCad+EDA+Softwaret+Suite/。 
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爱好 者 来 说 应 该 不 会 有 太 大 的 问题 。 但 是 ，EAGLE 的 学 习 曲 线 有 些 陡 峭 ， 而 且 我 觉 
得 界面 有 点 令 人 困惑 。 在 开始 之 前 ， 我 建议 你 先 看 一 些 视频 教程 “。 

































































B-3 从 原理 图 到 面包 板 原型 ， 再 到 PCB 电路 
EAGLE 中 的 典型 工作 流程 如 下 : 首先 ， 在 原理 图 编辑 器 中 创建 电路 图 。 为 此 ， 






































需要 添加 电路 中 使 用 的 元 件 ， 然 后 连 线 。EAGLE 有 大 量 的 元 件 库 ， 很 可 能 你 的 组 
件 已 经 在 那些 库 中 列 出 EAGLE 还 允许 你 创建 自己 定义 的 组 件 )。 完 成 原理 图 后 ， 
EAGLE 就 可 以 从 中 生成 一 个 PCB， 从 而 生成 这 些 元 件 的 物理 表示 。 然 后 ， 需 要 放 
置 元 件 并 完成 电路 布线 ,设计 PCB 上 铜 稍 层 的 连接 路 径 。 典 型 的 EAGLE 设计 如 图 
B-4 所 示 。 左 边 是 原理 图 ， 右 边 是 相应 的 电路 板 。 使 用 EAGLE 需要 一 些 练 习 ， 但 
YouTube 教程 将 帮助 你 起 步 。 

































































(D) Jeremy Blum, “Tutorial 1 for Eagle: Schematic Design”, YouTube (2012 年 6 H 14 H), https: // www.youtube.com/watch?v=1 AXwjZoyNno。 
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图 B-4 使 用 EAGLE 创建 的 电路 原理 图 和 相应 的 PCB 设计 


设计 了 PCB 后 ， 你 需要 制造 它 。 一 些 制造 PCB 的 技术 可 以 在 家 里 完成 "， 这 可 
以 很 有 趣 ， 但 更 专业 的 技术 是 将 你 的 设计 发 送 给 PCB 制 造 商 。 这 些 公司 通常 接受 
Gerber 设 计 格 式 ， 你 可 以 直接 从 EAGLE 生 成 这 些 文件 ， 只 需 一 点 设置 2。 许多 公司 
制造 PCB。 我 接触 过 一 个 很 好 的 公司 是 OSH Park”. 

完成 了 PCB 和 元 件 焊 接 后 ， 要 考虑 你 的 项 目的 外 壳 。 当 前 的 制造 技术 允许 你 用 
激光 打印 和 3D 打印 等 技术 ， 设 计 并 构建 专业 外 观 封装 。 你 可 以 使 用 2D? 和 3D? 软 
件 的 组 合 来 设计 你 的 作品 。Rich Decibels 的 一 个 项 目 很 好 地 说 明了 这 里 讨论 的 整个 
构建 过 程 “。 














B.4 下 一 步 


你 可 以 从 两 个 角度 来 探索 实用 电子 学 。 第 一 个 是 从 头 开 始 ， 学 习 将 简单 的 电路 
放 在 一 起 ， 了 解 模 拟 和 数字 电路 ， 最 后 继续 了 解 微 控 制 器 和 与 计算 机 的 接口 电路 。 
另 一 种 方法 是 从 编程 的 角度 开始 ， 即 从 Arduino 和 树 莓 派 等 硬件 友好 的 板 卡 开 始 ， 
然后 通过 为 这 些 板 卡 搭建 传感器 和 致 动 器 来 了 解 电路 。 两 种 方法 都 很 好 ， 大 多 数 时 
修 你 可 能 会 发 现 自己 处 于 两 者 之 间 。 






























































(D 在 家 里 制作 PCB 的 一 些 技术 可 以 在 https://embeddedinn.wordpress.com/tutorials/home-made-sigle-sided-pcbs/ 找 到 。 

@ Akash Patel, “Generating Gerber files from EAGLE”, YouTube(2010 年 4 月 7 日 ),https://www.youtube.com/watch?v=B_SbQeF83XU。 
© https://oshpark.com/. 

® 对 于 2D 软件 ， 请 参阅 Inkscape, http://www.inkscape.org/en/. 

OXF 3D 软件 ， 请 参阅 SketchUp, http: //www.sketchup.com/. 

© Rich Decibels, “Laser-Cut Project Box Tutorial, "Ponoko(2011 年 8 月 9 A), http://support.ponoko.com/entries/20344437-Laser- 


cut-project-box-tutorial/. 
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预 祝 你 在 电子 工程 方面 取得 巨大 成 功 。 一 旦 你 创建 了 某 个 作品 ， 我 希望 你 花 时 
记录 下 来 ， 并 与 世界 分 享 。 在 Instructables (http://www.instructables.com/) 这 样 的 
站 上 ， 可 以 分 享 你 的 项 目 ， 或 从 全 球 其 他 人 的 DIY 项 目 中 寻找 灵感 。 























aj 
































à] 











288 Python 极 客 项 目 编程 


附录 C 


树 每 派 的 建议 和 技巧 




















在 该 项 目 中 ， 我 介 É 了 基本 设置 ， 但 这 


















































BU. AVILA HER NEE IE 














C. 设置 Wi-Fi 
























































正如 你 在 第 14 章 中 学 到 的 ， 树 侮 派 是 一 个 带 有 操作 系统 
的 完整 计算 机 ， 这 意味 着 需要 一 些 设置 过 程 才能 开始 使 
里 有 一 些 额外 的 建议 和 


JE. 


在 第 14 章 中 , 我 建议 使 用 内 置 的 Wi-Fi 配置 实用 程序 , CER EW Wi-Fi. 





























但 利用 命令 行 ， 可 以 更 快 地 做 同样 的 事 。 首 先 ， 在 终端 
































编辑 器 中 显示 配置 文件 : 

















$ sudo nano /etc/wpa_supplicant/wpa_supplicant.conf 


输入 以 下 内 容 ， 在 nano 





我 的 文件 看 起 来 像 这 样 : 


ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev 
update_config=1 


network={ 
ssid-your-WiFi-network-name 
psk=your -password 
proto-RSN 
key mgmt-WPA-PSK 
pairwise-TKIP 
auth alg-OPEN 


w 





编辑 文件 的 内 容 , 设置 ssid 和 psk 以 符合 你 的 Wi-Fi Ut EL» BIA AP SE» network 
部 分 ， 请 输入 设置 (填写 与 你 自己 的 Wi-Fi 设置 相符 的 详细 信息 )。 



















































































C.2 检查 树 每 派 是 否 已 连接 


可 以 用 另 一 台 计算 机 的 ping 命令 ， 检 查 树 莓 派 是 否 连接 到 本 地 网 络 。 下 面 是 
ping 会 话 看 起 来 的 样子 : 


$ ping 192.168.4.32 

PING 192.168.4.32 (192.168.4.32): 56 data bytes 

64 bytes from 192.168.4.32: icmp_seq=0 ttl-64 time=13.677 ms 
64 bytes from 192.168.4.32: icmp_seq=1 ttl-64 time=8.277 ms 
64 bytes from 192.168.4.32: icmp seq-2 ttl-64 time=9.313 ms 
--snip-- 













































































这 个 ping 的 输出 显示 了 发 送 的 字 节 数 和 获取 应 答 所 花费 的 时 间 。 如 果 你 看 到 消 
息 “Request timeout…”， 就 知道 你 的 树 侮 派 未 连接 到 网 络 。 






































C.3 防止 Wi-Fi 适 配 堪 进入 有 睡眠 状态 


如 果 在 一 段 时 间 后 无 法 ping 通 树 侮 派 或 用 SHH 连接 ， 你 的 USB Wi-Fi 3T 
可 能 已 进入 睡眠 状态 。 可 以 通过 禁用 电源 管理 来 防止 这 种 情况 发 生 。 首 先 ， 使 ) 
面 的 命令 打开 控制 电源 管理 的 文件 : 
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$ sudo nano /etc/modprobe.d/8192cu.conf 


然后 将 以 下 内 容 添加 到 该 文件 中 : 


# disable power management 
options 8192cu rtw_power_mgnt=0 
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lumi 





新 启动 树 莓 派 ，Wi-EFi 适配器 现在 应 该 一 直 保持 工作 。 





C.4 从 树 每 派 备份 代码 和 数据 


当 你 在 树 侮 派 上 放置 越 来 越 多 的 代码 时 ， 需 要 一 种 备份 文件 的 方法 。rsync 是 
一 个 了 不 起 的 工具 ， 它 可 以 同步 两 个 文件 夹 之 间 的 文件 ， 即 使 它们 存在 于 网 络 上 的 
不 同 机 器 上 。rsync 非常 强大 ， 所 以 不 要 乱 动 它 ， 除 非 很 小 心 ， 否 则 可 能 会 导致 删 
除 原始 文件 。 如 果 你 是 第 一 次 用 它 ， 请 首先 备份 你 的 测试 文件 ， 并 使 用 -n 标志 (或 
者 叫 “ 彩 排 ”)。 这 样 ，rsync 只 告诉 你 它 会 做 什么 ， 而 不 实际 做 ， 这 样 你 有 机 会 熟 
悉 该 程序 ， 不 会 意外 删除 任何 东西 。 下 面 是 我 的 脚本 ， 从 树 侮 派 〈 递 归 地 ) 备份 代 
码 目 录 到 运行 OS X 的 计算 机 上 : 


#!/bin/bash 
echo Backing up RPi \#1... 
























































































































































# set this to Raspberry Pi IP address 
PI_ADDR="192.168.4.31" 


# set this to the Raspberry Pi code directory 
# note that the trailing slash (/) is important with rsync 
PI_DIR="code/" 


# set this to the local code (backup) directory 
BKUP DIR-"/Users/mahesh/code/rpi1/" 


# run rsync 

# use this first to test: 

# rsync -uvrn pi@$PI_ADDR:$PI_DIR $BKUP_DIR 
rsync -uvr pi@$PI_ADDR:$PI_DIR $BKUP_DIR 


echo ... 
echo done. 


# play sound (for OS X only) 
afplay /System/Library/Sounds/Basso. aiff 





请 修改 这 段 代 码 ， 以 符合 你 的 目录 。 对 于 Linux 和 OS X 用 户 ，rsync 已 内 置 。 
Windows 用 户 可 以 尝试 grsync%。 

















C.5 备份 整个 树 三 派 操作 系统 


备份 树 莓 派 上 的 操作 系统 是 一 个 好 主意 。 这 样 ， 如 果 由 于 不 正常 关机 导致 SD 
卡 上 的 文件 系统 损坏 ， 你 可 以 快速 地 将 操作 系统 重 写 到 SD 卡 ， 而 无 需 重 新 完成 整个 






























































® 你 可 以 从 http;//grsync-win.sourceforge.net/ F £X grsync - 用 于 Windows 的 rsync 端 
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的 一 个 解决 方案 ?介绍 了 在 Linux 和 OS X 上 使 用 dd 工具 ， 或 在 Windows 上 使 用 Win32 








Disk Imager 软 件 。 


C.6 利用 SSH 登录 到 树 莓 派 


























在 第 14 章 中 , 我 讨论 了 如 何方 便 地 利用 SSH 登 录 到 树 蓉 派 并 工作 。 如 果 你 不 仅 


























频繁 地 这 样 做 , 而 且 是 用 同一 台 计 算 机 , 可 能 会 觉得 每 次 输入 密码 很 烦人 。 使 用 SSH 
























































j 户 ，PuTTY 人 允许 你 进行 类 似 操作 ”)。 在 计算 机 的 终端 窗 
要 修改 树 春 派 的 耳 地 址 ; 








$ ssh-keygen 

Generating public/private rsa key pair. 

Enter file in which to save the key (/Users/xxx/.ssh/id_rsa): 
Enter passphrase (empty for no passphrase): 

Enter same passphrase again: 

Your identification has been saved in /Users/xxx/.ssh/id_rsa. 
Your public key has been saved in /Users/xxx/.ssh/id_rsa.pub. 
The key fingerprint is: 

--snip-- 


ME, RR REA SC AF EE BUY BE 


$ scp ~/.ssh/id_rsa.pub pi@192.168.4.32:.ssh/ 

















附带 的 ssh-keygen 实 用 程序 ， 你 可 以 设置 公共 /私有 密 钥 方 案 ， 以 便 安全 地 登录 到 树 
FIR, 而 无 需 输入 密码 。 对 于 OS X 和 Linux 用 户 , 请 按照 下 列 步 骤 操 作 ( 对 于 Windows 




















口 输入 以 下 内 容 ， 根 据 需 


The authenticity of host '192.168.4.32 (192.168.4.32)' can't be established. 
RSA key fingerprint is f1:ab:07:e7:dc:2e:f1:37:1b:6f:9b:66:85:2a:33:a7. 


Are you sure you want to continue connecting (yes/no)? yes 
Warning: Permanently added '192.168.4.32' (RSA) to the list of 
pi@192.168.4.32's password: 


known hosts. 


id rsa.pub 100% 398 0.4KB/s 00:00 


Ae. FOREVER: 


$ ssh pi@192.168.4.32 
pi@192.168.4.32's password: 


$ cd .ssh 
$ 1s 
id rsa.pub known hosts 








(D 你 可 以 在 Stack Exchange 上 找到 备份 树 侮 派 的 SD 卡 的 说 明 。“How do I backup my Raspberry Pi?”, Stack Exchange, 


http://raspberrypi.stackexchange.com/questions/3 | 1/how-do-i-backup-my-raspberry-pi/. 





@ “How to Create SSH Keys with PuTTY to Connect toa VPS”, DigitalOcean (2013 £7 H 19 


community/tutorials/how-to-create-ssh-keys-with -putty-to-connect-to-a-vps /。 
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), https://www.digitalocean.com/ 


C.7 


C.8 


C.9 


$ cat id_rsa.pub >> authorized_keys 


$ 1s 


authorized_keys id_rsa.pub known_hosts 


$ logout 








下 次 登录 树 莓 派 时 ， 系 统 不 会 要 求 你 输入 密码 。 另 外 ,请 注意 ， 我 在 ssh-keygen 
中 使 用 一 个 空 密码 ， 这 是 不 安全 的 。 这 个 设置 可 能 适用 于 树 薛 派 硬 件 项 目 ， 这 里 你 







































































不 太 在 意 安全 性 ,但 有 关 使 用 SSH 密 码 的 进一步 讨论 , 请 参阅 “Working with SSH Key 
Passphrases”, 这 是 一 篇 有 用 的 GitHub 文 章 ”。 




















使 用 树 醒 派 相 机 


如 果 你 想 用 树 莓 派 拍摄 照片 ， 有 一 个 专用 的 相机 模块 ?>。 该 模块 有 一 个 固定 售 
距 和 景深 的 相机 ， 相 机 支持 图 像 记 录 C5 百 万 像素 ) 和 视频 记录 (1080 像素 在 30 
帧 / 秒 )。 它 通过 带 状 电缆 连接 到 树 莓 派 。 安 装 相 机 模块 后 ， 可 以 使 用 raspistill 命 令 拍 
摄 照 片 或 视频 。 请 确保 在 首次 启动 树 侮 派 时 启用 相机 支持 。 在 安装 摄像 机 之 前 ， 请 
查看 安装 视频 ?。 这 段 视频 还 介绍 了 如 何 使 用 raspistil 命 令 。” 
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要 安装 ALSA LR. CAGE Web Design 的 一 个 资料 页 面 介 绍 了 它 的 安装 。 











让 树 每 派 说 话 


cm 
FH 


























在 树 侮 派 上 正常 工作 后 ， 让 它 说话 就 不 难 了 。 首 先 ， 需 要 安装 pyttsx， 这 





是 一 个 Python 文 本 转 语音 的 库 ”。 像 下 面 这 样 安装 它 : 


tar -xf 


€» €» €» €» € 





wget https://pypi.python.org/packages/source/p/pyttsx/pyttsx-1.1.tar.gz 
gunzip pyttsx-1.1.tar.gz 


pyttsx-1.1.tar 


cd pyttsx-1.1/ 
sudo python setup.py install 





(D) “Working with SSH Key Passphrases", GitHub #45, https://help.github.com/articles/working-with-ssh-key-passphrases/. 





@ 请 参阅 树 侮 派 相机 模块 的 产品 页 面 ， 网 址 为 http://www.raspberrypi.org/product/camera-module/。 
(& The RaspberryPiGuy, “Raspberry Pi-Camera Tutorial, ”YouTube(2013 年 5 月 26 日 ),https:/ www.youtube.com/watch?v=T8T6SSeFpqE。 
QD “Raspberry Pi 一 Getting Audio Working”, CAGE Web Design (2013 年 2 月 9 H), http: // cagewebdev.com/index.php/ 


raspberry-pi-getting-audio-working/. 
© 你 可 以 在 https:// github.com/parente/pyttsx/ FI] pyttsx 的 GitHub 库 ， 这 是 一 个 Python 文本 转 语音 的 库 。 
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然后 需要 安装 espeak， 如 下 所 示 : 


$ sudo apt-get install espeak 





现在 将 扬声器 连接 到 树 春 派 的 音频 插 孔 ， 并 运行 以 下 代码 ; 


import sy: 
import pyttsx 


# main() function 
def main(): 
# use sys.argv if needed 
print 'running speech-test.py...' 
engine = pyttsx.init() 
str = "I speak. Therefore. I am. " 
if len(sys.argv) > 1: 
str = sys.argv[1] 
engine.say(str) 
engine. runAndWait() 


# call main 
if name == ' main 
main() 





C.10 让 HDMI 工作 









































你 可 以 用 HDMI 电缆 将 树 莓 派 连 上 显示 器 或 ! 



































AER T 
如 下 所 示 : 


hdmi_force_hotplug=1 





TH 
< 



































BB 视 机 。 为 了 确保 它 在 
青 在 计算 机 中 打开 树 莓 派 的 SD 卡 , 并 在 顶层 目录 中 编辑 config.txt, 


现在 ， 如 果树 侮 派 启动 ， 你 应 该 能 够 通过 HDMI 看 到 输出 。 





C.11 RREI) 








总 是 可 以 让 树 莓 派 使 用 电源 适配器 。 但 有 些 时 候 ， 
昌 线 。 为 此 ， 你 需要 一 个 电池 组 。 
micro USB 输出 的 可 充电 电池 组 。 我 用 Anker Astro Mini 3000mAh 外 部 电池 
































而 没有 麻烦 的 

































































民 好 的 效果 ， 这 可 以 在 网 上 找到 ， 约 20 美元 。 


C.12 检查 树 年 派 的 硬件 版 本 


=> 











PREIA JUPAS © Ven] WEE BUY BE IRIE 





派 的 硬件 版 本 : 
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在 终端 











Ach 


一 次 启动 





aE 


N 








你 可 能 希望 让 树 侮 派 移动 ， 
一 个 效果 很 好 的 选项 是 


取得 了 








$ cat /proc/cpuinfo 








下 面 是 我 的 终端 上 的 输出 : 


processor : 0 
model name : 
BogoMIPS : 2.00 
Features : 
CPU implementer : 0x41 
CPU architecture: 7 
CPU variant : OxO 

CPU part : Oxb76 

CPU revision : 7 











Hardware : BCM2708 
Revision : 000f 
Serial : 00000000364a6f1c 











ARMv6-compatible processor rev 7 (v61) 


swp half thumb fastmult vfp edsp java tls 


要 了 解 修订 版 本 号 〈revision)， 请 参阅 http://elinux.org/RPi_HardwareHistory 上 




















的 硬件 修订 历史 记录 表 。 在 我 的 例子 
的 B 型 。 








， 是 2012 年 第 4 季度 制作 的 PCB 版 本 2.0 
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2 SARIS, $e RRMA? 


























Python 是 一 种 强大 的 编程 语言 ， 容 易学 习 而 且 充满 乐趣 。 但 掌 








本 书包 含 了 一 组 富有 想象 力 的 编程 项 目 ， 它 们 将 引导 你 用 Python xj 

































































像 和 音乐 、 模 拟 现 实 世界 的 现象 ， 并 与 
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IR] 
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Arduino 和 树 莓 派 这 样 的 硬件 进行 交互 。 你 将 学 习 使 用 常见 的 Python 工具 和 库 ， 如 numpy. matplotlib 和 pygame, 























来 完成 以 下 工作 : 





























e 利用 参数 方程 和 turtle 模 块 生成 万 花 尺 图 案 ; 

e 通过 模拟 频率 泛音 在 计算 机 上 创作 音乐 ; 

e 将 图 形 图 像 转换 为 ASCII 文 本 图 形 ; 

e 编写 一 个 三 维 立 体 画 程序 ， 生 成 隐藏 在 随机 图 案 下 的 3D 
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IR] 
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e 通过 探索 粒子 系统 、 透 明度 和 广告 牌 技术 ， 利 用 OpenGL 着 色 器 制作 逼真 的 动画 ; 















































e 利用 来 自 CT 和 MRI 扫描 的 数据 实现 3D 可 视 化; 
e 将 计算 机 连接 到 Arduino 编 程 ， 创 建 响应 音乐 的 激光 秀 。 



























































通过 本 书 ， 你 可 以 享受 作为 极 客 的 真正 乐趣 | 
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